CDataPathProperty::Open

virtual BOOL Open( COleControl* pControl, CFileException* pError = NULL );

virtual BOOL Open( LPCTSTR lpszPath, COleControl* pControl, CFileException* pError = NULL );

virtual BOOL Open( LPCTSTR lpszPath, CFileException* pError = NULL );

virtual BOOL Open( CFileException* pError = NULL );

Return Value

Nonzero if successful; otherwise 0.

Parameters

pControl

A pointer to the OLE control object to be associated with this CDataPathProperty object.

pError

A pointer to a file exception. In the event of an error, will be set to the cause.

lpszPath

The path, which may be absolute or relative, used to create an asynchronous moniker that references the actual absolute location of the property. CDataPathProperty uses URLs, not filenames. If you want a CDataPathProperty object for a file, prepend file:// to the path.

Remarks

Call this member function to initiate loading of the asynchronous property for the associated control. The function attempts to obtain the IBindHost interface from the control.

Before calling Open without a path, the value for the property's path must be set. This can be done when the object is constructed, or by calling the SetPath member function.

Before calling Open without a control, an ActiveX control (formerly known as an OLE control) can be associated with the object. This can be done when the object is constructed, or by calling SetControl.

All overloads of CAsyncMonikerFile::Open are also available from CDataPathProperty.

CDataPathProperty Overview | Class Members | Hierarchy Chart