IShellImageDataFactory::GetDataFormatFromPath-Methode (shimgdata.h)

Artikel
08/26/2023

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

Freigeben über