Metodo IStorage::Stat (objidl.h)

Articolo
02/29/2024

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