Método IColumnManager::GetColumns (shobjidl_core.h)

Obtém uma matriz de estruturas PROPERTYKEY que representam as colunas compatíveis com a exibição. Inclui todas as colunas ou apenas aquelas visíveis no momento.

Sintaxe

HRESULT GetColumns(
  [in]  CM_ENUM_FLAGS dwFlags,
  [out] PROPERTYKEY   *rgkeyOrder,
  [in]  UINT          cColumns
);

Parâmetros

[in] dwFlags

Tipo: CM_ENUM_FLAGS

Um valor da enumeração CM_ENUM_FLAGS que especifica se deve mostrar apenas colunas visíveis ou todas as colunas, independentemente da visibilidade.

[out] rgkeyOrder

Tipo: PROPERTYKEY*

Em caso de êxito, contém um ponteiro para uma matriz de estruturas PROPERTYKEY que representam as colunas.

[in] cColumns

Tipo: UINT

O comprimento da matriz rgkeyOrder .

Retornar valor

Tipo: HRESULT

Retorna um dos seguintes valores:

Código de retorno Descrição
S_OK
Coleção recuperada.
Falha
Todas as colunas não foram mapeadas para estruturas PROPERTYKEY .
E_INVALIDARG
O valor em cColumns é inconsistente com o valor em dwFlags.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [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)