IShellWindows::Item-Methode (exdisp.h)

  • Artikel

Gibt das registrierte Shellfenster für einen angegebenen Index zurück.

Syntax

HRESULT Item(
  [in, optional] VARIANT   index,
  [out, retval]  IDispatch **Folder
);

Parameter

[in, optional] index

Typ: VARIANT

Eine VARIANTE vom Typ VT_UI4, VT_I2 oder VT_I4. Wenn der Typ VT_UI4 ist, wird der Wert von index als Element von ShellWindowTypeConstants interpretiert. In diesem Fall gibt Item das Fenster zurück, das dem Vordergrundfenster am nächsten ist und einen übereinstimmenden Typ aufweist. Wenn der Typ VT_I oder VT_I4 ist, wird der Index als Index in der Shellfenstersammlung behandelt.

[out, retval] Folder

Typ: IDispatch**

Ein Verweis auf die IDispatch-Schnittstelle des Fensters oder NULL , wenn das angegebene Fenster nicht gefunden wurde.

Rückgabewert

Typ: HRESULT

Einer der folgenden Werte oder ein Standardergebniscode.

Rückgabecode BESCHREIBUNG
S_OK
 Das angegebene Fenster wurde gefunden.
S_FALSE
 Das angegebene Fenster wurde nicht gefunden.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile exdisp.h
DLL Shdocvw.dll (Version 5.00.2014.0216 oder höher)

Weitere Informationen

IShellWindows

IShellWindows::_NewEnum

IShellWindows::get_Count