SHMapPIDLToSystemImageListIndex-Funktion (shlobj_core.h)

  • Artikel

[SHMapPIDLToSystemImageListIndex ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Ruft den Symbolindex aus der Systembildliste ab, die einem Ordnerelement zugeordnet ist.

Syntax

int SHMapPIDLToSystemImageListIndex(
  [in]            IShellFolder    *pshf,
  [in]            PCUITEMID_CHILD pidl,
  [out, optional] int             *piIndexSel
);

Parameter

[in] pshf

Typ: IShellFolder*

Ein IShellFolder-Schnittstellenzeiger für den Ordner, der das Element enthält.

[in] pidl

Typ: PCUITEMID_CHILD

Ein Zeiger auf die ITEMIDLIST-Struktur des Elements.

[out, optional] piIndexSel

Typ: int*

Ein Zeiger auf einen Int-Wert , der den Index des geöffneten Symbols des Elements in der Systembildliste empfängt, wenn diese Funktion erfolgreich zurückgegeben wird. Wenn das Element kein spezielles geöffnetes Symbol hat, wird der Index des normalen Symbols zurückgegeben. Wenn das geöffnete Symbol vorhanden ist und nicht abgerufen werden kann, wird der Wert, auf den piIndex verweist, auf -1 festgelegt. Dieser Parameter kann NULL sein, wenn die aufrufende Anwendung nicht an dem geöffneten Symbol interessiert ist.

Rückgabewert

Typ: int

Gibt bei erfolgreicher Ausführung den Index des normalen Symbols des Elements in der Systembildliste zurück, andernfalls -1.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.0 oder höher)