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

  • Article

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

Voir aussi

IStream - Implémentation de fichiers composés

STATFLAG

STATSTG