Condividi tramite


Metodo IStorage::Stat (objidl.h)

Il metodo Stat recupera la struttura STATSTG per questo oggetto di archiviazione aperto.

Sintassi

HRESULT Stat(
  [out] STATSTG *pstatstg,
  [in]  DWORD   grfStatFlag
);

Parametri

[out] pstatstg

In caso di ritorno, puntatore a una struttura STATSTG in cui questo metodo inserisce informazioni sull'oggetto di archiviazione aperto. Questo parametro è NULL se si verifica un errore.

[in] grfStatFlag

Specifica che alcuni dei membri della struttura STATSTG non vengono restituiti, salvando così un'operazione di allocazione della memoria. I valori vengono acquisiti dall'enumerazione STATFLAG .

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK La struttura STATSTG è stata restituita correttamente nella posizione specificata.
E_PENDING Solo archiviazione asincrona: parte o tutti i dati dell'archiviazione non sono attualmente disponibili.
STG_E_ACCESSDENIED Il chiamante non dispone di autorizzazioni sufficienti per accedere alle statistiche per questo oggetto di archiviazione.
STG_E_INSUFFICIENTMEMORY La struttura STATSTG non è stata restituita a causa di una mancanza di memoria.
STG_E_INVALIDFLAG Il valore per il parametro grfStateFlag non è valido.
STG_E_INVALIDPARAMETER Uno dei parametri non è valido.

Commenti

IStorage::Stat recupera la struttura STATSTG per l'oggetto di archiviazione corrente. La struttura STATSTG contiene informazioni statistiche sull'oggetto di archiviazione. IStorage::EnumElements restituisce un puntatore a un oggetto enumeratore. L'oggetto enumeratore restituito da questo metodo implementa l'interfaccia IEnumSTATSTG , tramite cui vengono enumerati i dati archiviati nella matrice delle strutture STATSTG .

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione objidl.h
Libreria Uuid.lib
DLL Ole32.dll

Vedi anche

IEnumSTATSTG

IStorage - Implementazione di file composti

IStorage::SetClass

IStorage::SetElementTimes

IStorage::SetStateBits

STATFLAG

STATSTG