IShellImageStore::Open method (shlobj.h)

[IShellImageStore is supported through Windows XP. It is not supported in later operating systems.]

Opens the store and returns a lock.

Syntax

HRESULT Open(
        DWORD dwMode,
  [out] DWORD *pdwLock
);

Parameters

dwMode

Type: DWORD

The storage instantiation mode specified by one of the STGM values.

[out] pdwLock

Type: DWORD*

A pointer to a variable of type DWORD that receives the lock.

Return value

Type: HRESULT

If the process is successful, the method returns the result of StgOpenStorage. Otherwise, it returns one of the following values:

Return code Description
S_FALSE
The storage is already open with the instantiation mode specified by dwMode.
E_UNEXPECTED
An unexpected error occurred. For example, store path is not initialized.
STG_E_ACCESSDENIED
You do not have access to open the storage with the permissions specified by dwMode.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shlobj.h
DLL Shell32.dll (version 5.0 or later)