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