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 |