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

Artigo
02/23/2024

O método GetMaxLength recupera o comprimento máximo permitido, em bytes, para os dados da coluna.

Se o tipo de dados da coluna for PROPTYPE_STRING, divida o número de bytes por sizeof(WCHAR) para determinar o número máximo de caracteres Unicode .

Sintaxe

HRESULT GetMaxLength(
  [out] LONG *pMaxLength
);

Parâmetros

[out] pMaxLength

Um ponteiro para um valor de tipo LONG que contém o comprimento máximo permitido para os dados da coluna. Essa função falhará se pMaxLength for NULL.

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK e o pMaxLength será definido como o comprimento máximo permitido para os dados da coluna.

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 é o comprimento máximo permitido, em bytes, para os dados da coluna.

Comentários

Esse método é usado para determinar o comprimento máximo permitido de dados para a coluna que está sendo referenciada atualmente pela sequência de enumeração de coluna.

Se a sequência de enumeração de coluna não estiver fazendo referência a uma coluna válida, GetMaxLength 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.

Para determinar se os dados da coluna são indexados, chame o método IEnumCERTVIEWCOLUMN::IsIndexed .

Exemplos

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
HRESULT  hr;
LONG     nLength;

// determine database length
hr = pEnumCol->GetMaxLength(&nLength);
if (S_OK == hr)
    printf("max length is %d\n", nLength);

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