StgIsStorageFile, fonction (coml2api.h)

La fonction StgIsStorageFile indique si un fichier de disque particulier contient un objet de stockage.

Syntaxe

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

Paramètres

[in] pwcsName

Pointeur vers le nom de chaîne Unicode terminé par null du fichier de disque à examiner. Le paramètre pwcsName est passé sans interprétation au système de fichiers sous-jacent.

Valeur retournée

La fonction StgIsStorageFile peut également retourner des erreurs de système de fichiers ou des erreurs système encapsulées dans un HRESULT. Consultez Stratégies de gestion des erreurs et Gestion des erreurs inconnues

Remarques

Au début du fichier disque sous-jacent à un objet de stockage se trouve une signature qui distingue un objet de stockage des autres formats de fichier. La fonction StgIsStorageFile est utile pour les applications dont les documents utilisent un format de fichier disque qui peut ou non utiliser des objets de stockage.

Si un fichier composé racine a été créé en mode transactionné mais n’a pas encore été validée, cette méthode retourne toujours S_OK.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	coml2api.h (inclure Objbase.h)
Bibliothèque	Ole32.lib
DLL	Ole32.dll

Voir aussi

StgIsStorageILockBytes