Método IACList::Expand (shlobj_core.h)

Solicita que o cliente de preenchimento automático gere cadeias de caracteres candidatas associadas a um item especificado em seu namespace.

Sintaxe

HRESULT Expand(
  [in] PCWSTR pszExpand
);

Parâmetros

[in] pszExpand

Tipo: PCWSTR

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo a ser expandida pelo objeto de preenchimento automático.

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

O objeto de preenchimento automático chama esse método quando um delimitador é inserido no controle de edição. Se a cadeia de caracteres apontada por pszExpand corresponder a um item no namespace do cliente de preenchimento automático, o cliente gerará cadeias de caracteres para os itens que se enquadram imediatamente em pszExpand em sua hierarquia de namespace. O cliente retorna essas cadeias de caracteres na próxima vez que o objeto de preenchimento automático chamar a interface IEnumString do cliente.

Por exemplo, supondo que o namespace do cliente consiste em todos os arquivos e pastas na unidade C: e pszExpand está definido como "C:\Arquivos de Programas", o cliente deve gerar uma lista de cadeias de caracteres correspondentes aos caminhos totalmente qualificados dos arquivos e subpastas de "C:\Arquivos de Programas".

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [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	shlobj_core.h
DLL	Shell32.dll (versão 5.0 ou posterior)

Confira também

IACList