StgIsStorageFile-Funktion (coml2api.h)

  • Artikel

Die StgIsStorageFile-Funktion gibt an, ob eine bestimmte Datenträgerdatei ein Speicherobjekt enthält.

Syntax

HRESULT StgIsStorageFile(
  [in] const WCHAR *pwcsName
);

Parameter

[in] pwcsName

Zeiger auf den Namen der zu untersuchenden Datenträgerdatei, die mit NULL beendet wurde. Der pwcsName-Parameter wird uninterpretiert an das zugrunde liegende Dateisystem übergeben.

Rückgabewert

Die StgIsStorageFile-Funktion kann auch alle Dateisystemfehler oder Systemfehler zurückgeben, die in ein HRESULT umschlossen sind. Weitere Informationen finden Sie unter Strategien zur Fehlerbehandlung und Behandeln unbekannter Fehler.

Hinweise

Am Anfang der Datenträgerdatei, die einem Speicherobjekt zugrunde liegt, befindet sich eine Signatur, die ein Speicherobjekt von anderen Dateiformaten unterscheidet. Die StgIsStorageFile-Funktion ist nützlich für Anwendungen, deren Dokumente ein Datenträgerdateiformat verwenden, das Speicherobjekte verwenden kann oder nicht.

Wenn eine zusammengesetzte Stammdatei im Transaktionsmodus erstellt wurde, aber noch kein Commit ausgeführt wurde, gibt diese Methode weiterhin S_OK zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile coml2api.h (include Objbase.h)
Bibliothek Ole32.lib
DLL Ole32.dll

Weitere Informationen

StgIsStorageILockBytes