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

Artículo
02/26/2024

El método GetMaxLength recupera la longitud máxima permitida, en bytes, de los datos de columna.

Si el tipo de datos de columna es PROPTYPE_STRING, divida el número de bytes por sizeof(WCHAR) para determinar el número máximo de caracteres Unicode .

Sintaxis

HRESULT GetMaxLength(
  [out] LONG *pMaxLength
);

Parámetros

[out] pMaxLength

Puntero a un valor de tipo LONG que contiene la longitud máxima permitida para los datos de columna. Esta función producirá un error si pMaxLength es NULL.

Valor devuelto

C++

Si el método se realiza correctamente, el método devuelve S_OK y pMaxLength se establece en la longitud máxima permitida para los datos de columna.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

VB

El valor devuelto es la longitud máxima permitida, en bytes, para los datos de columna.

Comentarios

Este método se usa para determinar la longitud máxima de datos permitida para la columna a la que hace referencia la secuencia de enumeración de columnas.

Si la secuencia de enumeración de columnas no hace referencia a una columna válida, Se producirá un error en GetMaxLength . Use uno de los métodos siguientes para navegar por la enumeración :

IEnumCERTVIEWCOLUMN::Reset: se mueve al principio de la secuencia de enumeración.
IEnumCERTVIEWCOLUMN::Next: se mueve a la siguiente columna de la secuencia de enumeración.
IEnumCERTVIEWCOLUMN::Skip: omite un número especificado de columnas.

Para determinar si los datos de columna están indexados, llame al método IEnumCERTVIEWCOLUMN::IsIndexed .

Ejemplos

// 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	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certview.h (incluye Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certadm.dll