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

Inicializa um manipulador com um IShellItem.

Sintaxe

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

Parâmetros

[in] psi

Tipo: IShellItem*

Um ponteiro para um IShellItem.

[in] grfMode

Tipo: DWORD

Um dos seguintes valores STGM que indicam o modo de acesso para psi.

STGM_READ

O IShellItem é somente leitura.

STGM_READWRITE

O IShellItem é acessível para leitura/gravação.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se o IShellItem não puder ser acessado, esse método retornará um código de erro apropriado.

Uma instância de manipulador deve ser inicializada apenas uma vez em seu tempo de vida. As tentativas do aplicativo de chamada de reinicializar o manipulador resultam no erro HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Propsys.h)