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

Instrui um objeto de pasta shell a se inicializar com base nas informações passadas.

Sintaxe

HRESULT Initialize(
  PCIDLIST_ABSOLUTE pidl
);

Parâmetros

pidl

Tipo: LPCITEMIDLIST

O endereço da estrutura ITEMIDLIST (lista de identificadores de item) que especifica o local absoluto da pasta.

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

Todos os objetos que implementam a interface IShellFolder para uso no namespace do Shell devem implementar esse método. Quando o local de uma pasta no namespace não é uma consideração relevante, esse método pode simplesmente retornar S_OK. Quando o local for relevante para a pasta, você deverá armazenar a IDLIST totalmente qualificada passada para referência posterior.

Por exemplo, se a implementação da pasta precisar construir um ponteiro totalmente qualificado para uma PIDL (lista de identificadores de item) para elementos que ela contém, o PIDL passado para esse método deverá ser usado para construir os PIDLs totalmente qualificados.

Requisitos

Requisito	Valor
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)