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

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 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

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.

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

Confira também

IEnumCERTVIEWCOLUMN

IEnumCERTVIEWCOLUMN::IsIndexed

IEnumCERTVIEWCOLUMN::Next

IEnumCERTVIEWCOLUMN::Reset

IEnumCERTVIEWCOLUMN::Skip