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

Article
02/29/2024

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