StgIsStorageFile-Funktion (coml2api.h)
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 |