Método IEnumCERTVIEWCOLUMN::GetType (certview.h)

Artigo
02/28/2024

O método GetType recupera o tipo de dados da coluna atual na sequência de enumeração de coluna.

Sintaxe

HRESULT GetType(
  [out] LONG *pType
);

Parâmetros

[out] pType

Um ponteiro para uma variável do tipo LONG que denota o tipo de dados da coluna referenciada pela sequência de enumeração de coluna. Para obter uma tabela dos tipos de dados válidos, consulte Comentários. Esse método falhará se o parâmetro pType estiver definido como NULL.

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

VB

O valor retornado representa o tipo de dados da coluna. Para obter uma tabela dos tipos de dados válidos, consulte Comentários.

Comentários

Esse método é usado para determinar o tipo de dados da coluna referenciada atualmente pela sequência de enumeração de coluna. Os tipos de dados válidos são listados na tabela a seguir.

Tipo de dados	Significado
PROPTYPE_BINARY	Dados binários
PROPTYPE_DATE	Data/hora
PROPTYPE_LONG	Com assinatura longa
PROPTYPE_STRING	Cadeia de caracteres Unicode

Se a sequência de enumeração de coluna não estiver fazendo referência a uma coluna válida, GetType falhará. Use um dos seguintes métodos para navegar pela enumeração:

IEnumCERTVIEWCOLUMN::Reset: move para o início da sequência de enumeração.
IEnumCERTVIEWCOLUMN::Next: move para a próxima coluna na sequência de enumeração.
IEnumCERTVIEWCOLUMN::Skip: ignora um número especificado de colunas.

Exemplos

LONG     nType;
HRESULT  hr;

// pEnumCol is a previously instantiated IEnumCERTVIEWCOLUMN object.
hr = pEnumCol->GetType(&nType);
if (S_OK == hr)
{
    switch (nType)
    {
        case PROPTYPE_BINARY:
            printf("Type is Binary\n");
            break;
        case PROPTYPE_DATE:
            printf("Type is Date+Time\n");
            break;
        case PROPTYPE_LONG:
            printf("Type is Signed long\n");
            break;
        case PROPTYPE_STRING:
            printf("Type is Unicode String\n");
            break;
        default:
            printf("Type is unknown\n");
            break;
    }
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certview.h (inclua Certsrv.h)
Biblioteca	Certidl.lib
DLL	Certadm.dll