Método IInitializeWithFile::Initialize (propsys.h)

Inicializa un controlador con una ruta de acceso de archivo.

Sintaxis

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

Parámetros

[in] pszFilePath

Tipo: LPCWSTR

Puntero a un búfer que contiene la ruta de acceso del archivo como una cadena Unicode terminada en null.

[in] grfMode

Tipo: DWORD

Uno de los siguientes valores STGM que indica el modo de acceso para pszFilePath.

STGM_READ

El archivo indicado por IInitializeWithFile::Initialize es de solo lectura.

STGM_READWRITE

El archivo indicado por IInitializeWithFile::Initialize se puede leer y escribir en.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Se prefiere inicializar este método debido a su capacidad de usar archivos que no son accesibles a través de una ruta de acceso win32, como el contenido de un archivo comprimido con una extensión de nombre de archivo .zip. Use IInitializeWithFile::Initialize solo cuando la API usada por el controlador para acceder al archivo solo acepta rutas de acceso de archivo.

El archivo al que apunta pszFilePath debe permanecer abierto durante la vigencia del controlador o hasta que se llame a IPropertyStore::Commit .

Si el archivo no se puede abrir según los valores de parámetro del método, este método devuelve un código de error adecuado.

Una instancia del controlador solo se debe inicializar una vez en su duración. Los intentos de la aplicación que realiza la llamada para reinicializar el controlador deben producir el error HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	propsys.h