Compartir a través de

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

  • Artículo

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)