Freigeben über

IShellImageDataFactory::CreateImageFromFile-Methode (shimgdata.h)

  • Artikel

Erstellt eine instance der IShellImageData-Schnittstelle basierend auf einer bestimmten Datei.

Syntax

HRESULT CreateImageFromFile(
  [in]  LPCWSTR         pszPath,
  [out] IShellImageData **ppshimg
);

Parameter

[in] pszPath

Typ: LPCWSTR

Der Pfad der Datei, die das Bild enthält. Wenn dieser Parameter NULL ist, ergibt sich eine nicht behandelte Ausnahme.

[out] ppshimg

Typ: IShellImageData**

Die Adresse eines Zeigers auf eine instance von IShellImageData.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück, einschließlich der folgenden:

Rückgabecode Beschreibung
E_OUTOFMEMORY
 Das interne Objekt kann nicht instanziiert werden.
E_NOINTERFACE
 Das interne Objekt unterstützt die Schnittstellen IShellImageData oder IPersistFile nicht.
E_POINTER
 Der ppshimg-Parameter ist NULL.

Hinweise

Eine Zugriffsverletzung tritt auf, wenn pszPathNULL ist.

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 shimgdata.h
DLL Shell32.dll