Méthode IByteBuffer::Stat

Article
06/13/2023

[La méthode Stat est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il n’est pas disponible pour une utilisation dans Windows Server 2003 avec Service Pack 1 (SP1) et versions ultérieures, Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation. L’interface IStream fournit des fonctionnalités similaires.]

La méthode Stat récupère des informations statistiques à partir de l’objet stream.

Syntaxe

HRESULT Stat(
  [out] LPSTATSTRUCT pstatstg,
  [in]  LONG         grfStatFlag
);

Paramètres

pstatstg [out]: Pointe vers une structure STATSTRUCT où cette méthode place des informations sur cet objet de flux. Ce pointeur a la valeur NULL si une erreur se produit.
grfStatFlag [in]: Spécifie que cette méthode ne retourne pas certains des champs de la structure STATSTRUCT , 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

La valeur de retour est HRESULT. La valeur S_OK indique que l’appel a réussi.

Notes

La méthode IByteBuffer::Stat récupère un pointeur vers la structure STATSTRUCT qui contient des informations sur ce flux ouvert.

Exemples

L’exemple suivant montre comment récupérer des informations statistiques à partir du flux.

STATSTRUCT  statstr;
HRESULT     hr;

// Retrieve the statistical information.
hr = pIByteBuff->Stat(&statstr,
                      STATFLAG_DEFAULT);
if (FAILED(hr))
  printf("Failed IByteBuffer::Stat\n");
else
  // Use statstr as needed.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Fin de la prise en charge des clients	Windows XP
Fin de la prise en charge des serveurs	Windows Server 2003
En-tête	Scardssp.h
Bibliothèque de types	Scardssp.tlb
DLL	Scardssp.dll
IID	IID_IByteBuffer est défini comme E126F8FE-A7AF-11D0-B88A-00C04FD424B9

Partager via