Método ICategorizer::GetDescription (shobjidl_core.h)

  • Artigo

Obtém o nome de um categorizador, como Agrupar por Tipo de Dispositivo, que pode ser exibido na interface do usuário.

Sintaxe

HRESULT GetDescription(
  [out] LPWSTR pszDesc,
  [in]  UINT   cch
);

Parâmetros

[out] pszDesc

Tipo: LPWSTR

Quando esse método retorna, contém um ponteiro para uma cadeia de caracteres de comprimento cch que contém o nome do categorizador.

[in] cch

Tipo: UINT

O número de caracteres no buffer pszDesc .

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

No caso do objeto de exibição de pasta do sistema, se a descrição em pszDesc corresponder a um dos nomes de categoria listados no menu Organizar Ícones por da pasta, um ponto será colocado por esse nome quando o menu for exibido, por meio do menu Exibir ou por meio do menu de contexto.

Requisitos

Requisito Valor
Cliente mínimo com suporte 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