Freigeben über

SHCreateFileExtractIconW-Funktion (shlobj_core.h)

  • Artikel

[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 SHCreateFileExtractIconW(
  [in] LPCWSTR 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

Anforderung Wert
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)