Método IPersistFolder3::InitializeEx (shobjidl_core.h)

Inicializa uma pasta e especifica sua localização no namespace . Se a pasta for um atalho, esse método também especificará o local da pasta de destino.

Sintaxe

HRESULT InitializeEx(
  [in] IBindCtx                         *pbc,
  [in] PCIDLIST_ABSOLUTE                pidlRoot,
  [in] const PERSIST_FOLDER_TARGET_INFO *ppfti
);

Parâmetros

[in] pbc

Tipo: IBindCtx*

Um ponteiro para um objeto IBindCtx que fornece o contexto de associação. Este parâmetro pode ser NULL.

[in] pidlRoot

Tipo: LPCITEMIDLIST

Um ponteiro para um PIDL totalmente qualificado que especifica o local absoluto de uma pasta ou atalho de pasta. O aplicativo de chamada é responsável por alocar e liberar esse PIDL.

[in] ppfti

Tipo: const PERSIST_FOLDER_TARGET_INFO*

Um ponteiro para uma estrutura PERSIST_FOLDER_TARGET_INFO que especifica o local da pasta de destino e seus atributos.

Se ppfti apontar para uma estrutura válida, pidlRoot representará um atalho de pasta.

Se ppfti for definido como NULL, pidlRoot representará uma pasta normal. Nesse caso, InitializeEx deve se comportar como se Initialize tivesse sido chamado.

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

Essa função é uma versão estendida de IPersistFolder::Initialize. Ele permite que o Shell inicialize atalhos de pasta, bem como pastas normais.

Requisitos

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