Metodo IInitializeWithFile::Initialize (propsys.h)

Inizializza un gestore con un percorso di file.

Sintassi

HRESULT Initialize(
  [in] LPCWSTR pszFilePath,
  [in] DWORD   grfMode
);

Parametri

[in] pszFilePath

Tipo: LPCWSTR

Puntatore a un buffer che contiene il percorso del file come stringa Unicode con terminazione Null.

[in] grfMode

Tipo: DWORD

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

STGM_READ

Il file indicato da IInitializeWithFile::Initialize è di sola lettura.

STGM_READWRITE

Il file indicato da IInitializeWithFile::Initialize può essere letto da e scritto in .

Valore restituito

Tipo: HRESULT

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

Commenti

L'inizializzazione è preferibile a questo metodo a causa della possibilità di usare file che non sono accessibili tramite un percorso Win32, ad esempio il contenuto di un file compresso con un'estensione di file .zip. Usare IInitializeWithFile::Initialize solo quando l'API usata dal gestore per accedere al file accetta solo i percorsi di file.

Il file a cui punta pszFilePath deve rimanere aperto per tutta la durata del gestore o finché non viene chiamato IPropertyStore::Commit .

Se il file non può essere aperto in base ai valori dei parametri del metodo, questo metodo restituisce un codice di errore appropriato.

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

Requisiti