Funzione StgIsStorageFile (coml2api.h)
La funzione StgIsStorageFile indica se un determinato file del disco contiene un oggetto di archiviazione.
Sintassi
HRESULT StgIsStorageFile(
[in] const WCHAR *pwcsName
);
Parametri
[in] pwcsName
Puntatore al nome della stringa Unicode con terminazione Null del file del disco da esaminare. Il parametro pwcsName viene passato non interpretato al file system sottostante.
Valore restituito
La funzione StgIsStorageFile può anche restituire eventuali errori del file system o errori di sistema di cui è stato eseguito il wrapping in un HRESULT. Vedere Strategie di gestione degli errori e gestione degli errori sconosciuti
Commenti
All'inizio del file del disco sottostante un oggetto di archiviazione è una firma che distingue un oggetto di archiviazione da altri formati di file. La funzione StgIsStorageFile è utile per le applicazioni i cui documenti usano un formato di file su disco che potrebbe o meno usare oggetti di archiviazione.
Se un file composto radice è stato creato in modalità transazionata ma non è ancora stato eseguito il commit, questo metodo restituisce comunque S_OK.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
Piattaforma di destinazione | Windows |
Intestazione | coml2api.h (include Objbase.h) |
Libreria | Ole32.lib |
DLL | Ole32.dll |