IInitializeWithItem::Initialize-Methode (shobjidl_core.h)

  • Artikel

Initialisiert einen Handler mit einem IShellItem.

Syntax

HRESULT Initialize(
  [in] IShellItem *psi,
  [in] DWORD      grfMode
);

Parameter

[in] psi

Typ: IShellItem*

Ein Zeiger auf ein IShellItem.

[in] grfMode

Art: DWORD

Einer der folgenden STGM-Werte , der den Zugriffsmodus für psi angibt.

STGM_READ

IShellItem ist schreibgeschützt.

STGM_READWRITE

Auf das IShellItem kann mit Lese-/Schreibzugriff zugegriffen werden.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn auf das IShellItem nicht zugegriffen werden kann, gibt diese Methode einen entsprechenden Fehlercode zurück.

Ein Handler instance sollte nur einmal in seiner Lebensdauer initialisiert werden. Versuche der aufrufenden Anwendung, den Handler neu zu initialisieren, führen zu dem Fehler HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Propsys.h)