IShellImageDataFactory::GetDataFormatFromPath-Methode (shimgdata.h)

  • Artikel

Bestimmt das Format einer Datei basierend auf der Erweiterung.

Syntax

HRESULT GetDataFormatFromPath(
  [in]  LPCWSTR pszPath,
  [out] GUID    *pDataFormat
);

Parameter

[in] pszPath

Typ: LPCWSTR

Ein Pfad zur Datei.

[out] pDataFormat

Typ: GUID*

Ein Zeiger auf eine GUID, die das Bildformat der Datei identifiziert.

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_FAIL
 Der pszPath-Parameter ist NULL, die Dateinamenerweiterung entspricht keinem definierten GDI+-Decoder, oder es ist ein interner Fehler aufgetreten. In jedem dieser Fälle ist pDataFormat auf GUID_NULL festgelegt.
E_OUTOFMEMORY
 Das interne Objekt kann nicht instanziiert werden.

Hinweise

IShellImageDataFactory::GetDataFormatFromPath sollte nur verwendet werden, um zu bestimmen, ob Daten in einem bestimmten Format auf dem aktuellen System gespeichert werden können.

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