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

Inicializa un controlador con una secuencia.

Sintaxis

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

Parámetros

[in] pstream

Tipo: IStream*

Puntero a una interfaz IStream que representa el origen de la secuencia.

[in] grfMode

Tipo: DWORD

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

STGM_READ

La secuencia indicada por pstream es de solo lectura.

STGM_READWRITE

La secuencia indicada por pstream es accesible de lectura y escritura.

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

Este método se prefiere inicializar debido a su capacidad de usar secuencias 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.

La secuencia a la que apunta pstream debe permanecer abierta durante la vigencia del controlador o hasta que se llame a IPropertyStore::Commit .

Cuando se abre por primera vez, la referencia de flujo de origen apunta al principio de la secuencia. El controlador puede buscar y leer desde la secuencia en cualquier momento. Un controlador se puede implementar para leer todas las propiedades de la secuencia durante Initialize o puede esperar hasta que el proceso de llamada intente enumerar o leer propiedades antes de capturarlas de la secuencia.

Una instancia del controlador solo se debe inicializar una vez en su duración. Los intentos por parte del autor de 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