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)