Metodo IByteBuffer::Stat

[Il metodo Stat è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Non è disponibile per l'uso in Windows Server 2003 con Service Pack 1 (SP1) e versioni successive, Windows Vista, Windows Server 2008 e versioni successive del sistema operativo. L'interfaccia IStream offre funzionalità simili.

Il metodo Stat recupera informazioni statistiche dall'oggetto flusso.

Sintassi

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

Parametri

pstatstg [out]

Punta a una struttura STATSTRUCT in cui questo metodo inserisce informazioni su questo oggetto flusso. Questo puntatore è NULL se si verifica un errore.

grfStatFlag [in]

Specifica che questo metodo non restituisce alcuni campi nella struttura STATSTRUCT , salvando così un'operazione di allocazione della memoria. I valori vengono acquisiti dall'enumerazione STATFLAG

Valore restituito

Il valore restituito è HRESULT. Un valore di S_OK indica che la chiamata ha avuto esito positivo.

Commenti

Il metodo IByteBuffer::Stat recupera un puntatore alla struttura STATSTRUCT che contiene informazioni su questo flusso aperto.

Esempio

Nell'esempio seguente viene illustrato il recupero di informazioni statistiche dal flusso.

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.

Requisiti

Requisito Valore
Client minimo supportato
Windows XP [solo app desktop]
Server minimo supportato
Windows Server 2003 [solo app desktop]
Fine del supporto client
Windows XP
Fine del supporto server
Windows Server 2003
Intestazione
Scardssp.h
Libreria dei tipi
Scardssp.tlb
DLL
Scardssp.dll
IID
IID_IByteBuffer è definito come E126F8FE-A7AF-11D0-B88A-00C04FD424B9