SHCreateFileExtractIconA-Funktion (shlobj_core.h)

Artikel
08/26/2023

[SHCreateFileExtractIcon 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.]

Erstellt einen IExtractIcon-Standardhandler für ein Dateisystemobjekt. Namespaceerweiterungen, die Dateisystemobjekte anzeigen, verwenden in der Regel diese Funktion. Die Erweiterungs- und Dateiattribute leiten alles ab, was für einen einfachen Symbolextraktor benötigt wird.

Syntax

SHSTDAPI SHCreateFileExtractIconA(
  [in] LPCSTR pszFile,
  [in] DWORD  dwFileAttributes,
  [in] REFIID riid,
       void   **ppv
);

Parameter

[in] pszFile

Typ: LPCTSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge, die das Dateisystemobjekt angibt. Der Puffer darf MAX_PATH Zeichen nicht überschreiten.

[in] dwFileAttributes

Art: DWORD

Eine Kombination aus mindestens einem Dateiattributeflag (FILE_ATTRIBUTE_*-Werten, wie in Winnt.h definiert), die den Typ des Objekts angeben.

[in] riid

Typ: REFIID

Verweis auf die gewünschte Schnittstellen-ID der zu erstellenden Symbolextraktorschnittstelle. Dies muss entweder IID_IExtractIconA oder IID_IExtractIconW sein.

ppv

Typ: void**

Wenn diese Funktion zurückgibt, enthält den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel IExtractIcon.

Rückgabewert

Typ: HRESULT

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

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 (shlobj.h einschließen)
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 5.0 oder höher)

Share via