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

  • Artigo

Inicializa uma extensão de folha de propriedades, uma extensão de menu de atalho ou um manipulador de arrastar e soltar.

Sintaxe

HRESULT Initialize(
  [in] PCIDLIST_ABSOLUTE pidlFolder,
  [in] IDataObject       *pdtobj,
  [in] HKEY              hkeyProgID
);

Parâmetros

[in] pidlFolder

Tipo: PCIDLIST_ABSOLUTE

Um ponteiro para uma estrutura ITEMIDLIST que identifica exclusivamente uma pasta. Para extensões de folha de propriedades, esse parâmetro é NULL. Para extensões de menu de atalho, é a lista de identificadores de item da pasta que contém o item cujo menu de atalho está sendo exibido. Para extensões de menu de arrastar e soltar não padrão, esse parâmetro especifica a pasta de destino.

[in] pdtobj

Tipo: IDataObject*

Um ponteiro para um objeto de interface IDataObject que pode ser usado para recuperar os objetos que estão sendo tratados.

[in] hkeyProgID

Tipo: HKEY

A chave do Registro para o objeto de arquivo ou o tipo de pasta.

Valor retornado

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

Os significados de alguns parâmetros dependem do tipo de extensão. Para manipuladores de arrastar e soltar, o parâmetro pidlFolder especifica a pasta de destino (o destino de soltar), o parâmetro pdtobj identifica os itens que estão sendo descartados e o parâmetro hkeyProgID especifica o tipo de arquivo da pasta de destino.

Para extensões de menu de atalho, pdtobj identifica os objetos de arquivo selecionados, hkeyProgID identifica o tipo de arquivo do objeto com foco e pidlFolder é NULL (para objetos de arquivo) ou especifica a pasta para a qual o menu de atalho está sendo solicitado (para menus de atalho em segundo plano da pasta).

Para extensões de folha de propriedades, pidlFolder é NULL, pdtobj identifica os objetos de arquivo selecionados e hkeyProgID especifica o tipo de arquivo do objeto de arquivo que tem o foco.

Anotações aos implementadores

Esse é o primeiro método que o Shell chama depois de criar uma instância de uma extensão de folha de propriedades, uma extensão de menu de atalho ou um manipulador de arrastar e soltar.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)
DLL Shell32.dll (versão 4.0 ou posterior)