Metodo IInitializeWithStream::Initialize (propsys.h)

Articolo
03/01/2024

Inizializza un gestore con un flusso.

Sintassi

HRESULT Initialize(
  [in] IStream *pstream,
  [in] DWORD   grfMode
);

Parametri

[in] pstream

Tipo: IStream*

Puntatore a un'interfaccia IStream che rappresenta l'origine del flusso.

[in] grfMode

Tipo: DWORD

Uno dei valori STGM seguenti che indica la modalità di accesso per pstream.

STGM_READ

Il flusso indicato da pstream è di sola lettura.

STGM_READWRITE

Il flusso indicato da pstream è accessibile in lettura/scrittura.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo è preferito inizializzare a causa della sua capacità di usare i flussi che non sono accessibili tramite un percorso Win32, ad esempio il contenuto di un file compresso con un'estensione del nome file .zip.

Il flusso a cui punta da pstream deve rimanere aperto per la durata del gestore o fino a quando non viene chiamato IPropertyStore::Commit .

Quando si apre per la prima volta, il flusso di origine fa riferimento all'inizio del flusso. Il gestore può cercare e leggere dal flusso in qualsiasi momento. Un gestore può essere implementato per leggere tutte le proprietà dal flusso durante l'inizializzazione oppure può attendere fino a quando il processo chiamante tenta di enumerare o leggere le proprietà prima di recuperarle dal flusso.

Un'istanza del gestore deve essere inizializzata una sola volta nella sua durata. I tentativi del chiamante per reinizializzare il gestore devono causare l'errore HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED).

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	propsys.h

Condividi tramite