Metodo IStream::Stat (objidl.h)

  • Articolo

Il metodo Stat recupera la struttura STATSTG per questo flusso.

Sintassi

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

Parametri

[out] pstatstg

Puntatore a una struttura STATSTG in cui questo metodo inserisce informazioni su questo oggetto flusso.

[in] grfStatFlag

Specifica che questo metodo non restituisce alcuni membri nella struttura STATSTG , salvando così un'operazione di allocazione della memoria. I valori vengono ricavati 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 del flusso 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_INVALIDPOINTER Il puntatore pStatStg non è valido.
STG_E_REVERTED L'oggetto è stato invalidato da un'operazione di ripristino sopra di essa nell'albero delle transazioni.

Commenti

IStream::Stat recupera un puntatore alla struttura STATSTG che contiene informazioni su questo flusso aperto. Quando questo flusso si trova all'interno di un archivio strutturato e viene chiamato IStorage::EnumElements , crea un oggetto enumeratore con l'interfaccia IEnumSTATSTG , che può essere chiamato per enumerare le risorse di archiviazione e i flussi attraverso le strutture STATSTG associate a ognuna di esse.

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

IStream - Implementazione di file composti

STATFLAG

STATSTG