Método IInitializeWithItem::Initialize (shobjidl_core.h)

Inicializa un controlador con un objeto IShellItem.

Sintaxis

HRESULT Initialize(
  [in] IShellItem *psi,
  [in] DWORD      grfMode
);

Parámetros

[in] psi

Tipo: IShellItem*

Puntero a un objeto IShellItem.

[in] grfMode

Tipo: DWORD

Uno de los siguientes valores STGM que indican el modo de acceso para psi.

STGM_READ

IShellItem es de solo lectura.

STGM_READWRITE

IShellItem 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

Si no se puede acceder al objeto IShellItem , 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 producen 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	shobjidl_core.h (include Propsys.h)