Méthode IStream ::Stat (objidl.h)
La méthode Stat récupère la structure STATSTG pour ce flux.
Syntaxe
HRESULT Stat(
[out] STATSTG *pstatstg,
[in] DWORD grfStatFlag
);
Paramètres
[out] pstatstg
Pointeur vers une structure STATSTG où cette méthode place des informations sur cet objet de flux.
[in] grfStatFlag
Spécifie que cette méthode ne retourne pas certains des membres de la structure STATSTG , 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 flux n’est actuellement pas disponible. |
| STG_E_ACCESSDENIED | L’appelant ne dispose pas d’autorisations suffisantes pour accéder aux statistiques pour 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_INVALIDPOINTER | Le pointeur pStatStg n’est pas valide. |
| STG_E_REVERTED | L’objet a été invalidé par une opération de restauration au-dessus de lui dans l’arborescence des transactions. |
Remarques
IStream ::Stat récupère un pointeur vers la structure STATSTG qui contient des informations sur ce flux ouvert. Lorsque ce flux se trouve dans un stockage structuré et que IStorage ::EnumElements est appelé, il crée un objet énumérateur avec l’interface IEnumSTATSTG sur celui-ci, qui peut être appelé pour énumérer les stockages et les flux via les structures STATSTG associées à chacune d’elles.
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 |