IInitializeWithFile::Initialize method (propsys.h)
Initializes a handler with a file path.
Syntax
HRESULT Initialize(
[in] LPCWSTR pszFilePath,
[in] DWORD grfMode
);
Parameters
[in] pszFilePath
Type: LPCWSTR
A pointer to a buffer that contains the file path as a null-terminated Unicode string.
[in] grfMode
Type: DWORD
One of the following STGM values that indicates the access mode for pszFilePath.
STGM_READ
The file indicated by IInitializeWithFile::Initialize is read-only.
STGM_READWRITE
The file indicated by IInitializeWithFile::Initialize can be read from and written to.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
Initialize is preferred to this method because of its ability to use files that are not accessible through a Win32 path, such as the contents of a compressed file with a .zip file name extension. Use IInitializeWithFile::Initialize only when the API used by the handler to access the file accepts file paths only.
The file pointed to by pszFilePath must remain open for the lifetime of the handler or until IPropertyStore::Commit is called.
If the file cannot be opened according to the method's parameter values, this method returns a suitable error code.
A handler instance should be initialized only once in its lifetime. Attempts by the calling application to reinitialize the handler should result in the error HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2008 [desktop apps only] |
Target Platform | Windows |
Header | propsys.h |