Método ICategoryProvider::GetDefaultCategory (shobjidl_core.h)

Permite que a pasta substitua o agrupamento padrão.

Sintaxe

HRESULT GetDefaultCategory(
  [out] GUID       *pguid,
  [out] SHCOLUMNID *pscid
);

Parâmetros

[out] pguid

Tipo: GUID*

Não usado.

[out] pscid

Tipo: SHCOLUMNID*

Quando esse método retorna, contém um ponteiro para uma estrutura SHCOLUMNID .

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, caso contrário, incluindo o seguinte:

Código de retorno	Descrição
S_FALSE	Não há nenhum grupo padrão.

Comentários

ICategoryProvider::GetDefaultCategory retorna uma estrutura SHCOLUMNID usada pelo categorizador padrão. O método retornará S_FALSE se não houver suporte para um grupo padrão.

ICategoryProvider::GetDefaultCategory é chamado somente quando uma pasta é aberta pela primeira vez. Depois disso, a opção de agrupamento do usuário é armazenada em cache no recipiente de propriedades que armazena o estado da exibição. Para forçar uma chamada para ICategoryProvider::GetDefaultCategory depois que a pasta for aberta pela primeira vez, as chaves do registro Shell e ShellNoRoam devem ser excluídas. Eles são encontrados no local a seguir.

HKEY_CURRENT_USER
   Software
      Microsoft
         Windows
            Shell
            ShellNoRoam

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