Partager via


Méthode IStorage ::Stat (objidl.h)

La méthode Stat récupère la structure STATSTG pour cet objet de stockage ouvert.

Syntaxe

HRESULT Stat(
  [out] STATSTG *pstatstg,
  [in]  DWORD   grfStatFlag
);

Paramètres

[out] pstatstg

Au retour, pointez vers une structure STATSTG où cette méthode place des informations sur l’objet de stockage ouvert. Ce paramètre a la valeur NULL si une erreur se produit.

[in] grfStatFlag

Spécifie que certains des membres de la structure STATSTG ne sont pas retournés, ce qui permet d’enregistrer une opération d’allocation de mémoire. Les valeurs sont extraites de l’énumération STATFLAG .

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK La structure STATSTG a été retournée à l’emplacement spécifié.
E_PENDING Stockage asynchrone uniquement : une partie ou la totalité des données du stockage sont actuellement indisponibles.
STG_E_ACCESSDENIED L’appelant ne dispose pas d’autorisations suffisantes pour accéder aux statistiques de cet objet de stockage.
STG_E_INSUFFICIENTMEMORY La structure STATSTG n’a pas été retournée en raison d’un manque de mémoire.
STG_E_INVALIDFLAG La valeur du paramètre grfStateFlag n’est pas valide.
STG_E_INVALIDPARAMETER L’un des paramètres n’était pas valide.

Remarques

IStorage ::Stat récupère la structure STATSTG pour l’objet de stockage actuel. La structure STATSTG contient des informations statistiques sur l’objet de stockage. IStorage ::EnumElements retourne un pointeur vers un objet énumérateur. L’objet énumérateur retourné par cette méthode implémente l’interface IEnumSTATSTG , par le biais de laquelle les données stockées dans le tableau des structures STATSTG sont énumérées.

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 objidl.h
Bibliothèque Uuid.lib
DLL Ole32.dll

Voir aussi

IEnumSTATSTG

IStorage - Implémentation de fichiers composés

IStorage ::SetClass

IStorage ::SetElementTimes

IStorage ::SetStateBits

STATFLAG

STATSTG