IInitializeWithFile::Initialize-Methode (propsys.h)

Initialisiert einen Handler mit einem Dateipfad.

Syntax

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

Parameter

[in] pszFilePath

Typ: LPCWSTR

Ein Zeiger auf einen Puffer, der den Dateipfad als Unicode-Zeichenfolge mit NULL-Beendigung enthält.

[in] grfMode

Art: DWORD

Einer der folgenden STGM-Werte , der den Zugriffsmodus für pszFilePath angibt.

STGM_READ

Die von IInitializeWithFile::Initialize angegebene Datei ist schreibgeschützt.

STGM_READWRITE

Die von IInitializeWithFile::Initialize angegebene Datei kann aus gelesen und in geschrieben werden.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Initialisieren wird dieser Methode vorgezogen, da dateien verwendet werden können, auf die nicht über einen Win32-Pfad zugegriffen werden kann, z. B. der Inhalt einer komprimierten Datei mit einer .zip Dateinamenerweiterung. Verwenden Sie IInitializeWithFile::Initialize nur, wenn die API, die vom Handler für den Zugriff auf die Datei verwendet wird, nur Dateipfade akzeptiert.

Die Datei, auf die von pszFilePath verwiesen wird, muss für die Lebensdauer des Handlers oder bis zum Aufruf von IPropertyStore::Commit geöffnet bleiben.

Wenn die Datei nicht gemäß den Parameterwerten der Methode geöffnet werden kann, gibt diese Methode einen geeigneten Fehlercode zurück.

Ein Handler instance sollte nur einmal in seiner Lebensdauer initialisiert werden. Versuche der aufrufenden Anwendung, den Handler neu zu initialisieren, sollten zum Fehler HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)führen.

Anforderungen