Metodo IEnumCERTVIEWCOLUMN::GetMaxLength (certview.h)

Articolo
03/14/2023

Il metodo GetMaxLength recupera la lunghezza massima consentita, in byte, per i dati della colonna.

Se il tipo di dati della colonna è PROPTYPE_STRING, dividere il numero di byte sizeof(WCHAR) per per determinare il numero massimo di caratteri Unicode .

Sintassi

HRESULT GetMaxLength(
  [out] LONG *pMaxLength
);

Parametri

[out] pMaxLength

Puntatore a un valore di tipo LONG che contiene la lunghezza massima consentita per i dati della colonna. Questa funzione avrà esito negativo se pMaxLength è NULL.

Valore restituito

C++

Se il metodo ha esito positivo, il metodo restituisce S_OK e pMaxLength viene impostato sulla lunghezza massima consentita per i dati della colonna.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

VB

Il valore restituito è la lunghezza massima consentita, espressa in byte, per i dati della colonna.

Commenti

Questo metodo viene usato per determinare la lunghezza massima consentita dei dati per la colonna a cui fa attualmente riferimento la sequenza di enumerazione di colonna.

Se la sequenza di enumerazione di colonna non fa riferimento a una colonna valida, GetMaxLength avrà esito negativo. Usare uno dei metodi seguenti per spostarsi nell'enumerazione :

IEnumCERTVIEWCOLUMN::Reset: passa all'inizio della sequenza di enumerazione.
IEnumCERTVIEWCOLUMN::Next: passa alla colonna successiva nella sequenza di enumerazione.
IEnumCERTVIEWCOLUMN::Skip: ignora un numero specificato di colonne.

Per determinare se i dati della colonna sono indicizzati, chiamare il metodo IEnumCERTVIEWCOLUMN::IsIndexed .

Esempio

// 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);

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certview.h (include Certsrv.h)
Libreria	Certidl.lib
DLL	Certadm.dll