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

Article
02/26/2024

La méthode GetMaxLength récupère la longueur maximale autorisée, en octets, pour les données de colonne.

Si le type des données de colonne est PROPTYPE_STRING, divisez le nombre d’octets par sizeof(WCHAR) pour déterminer le nombre maximal de caractères Unicode .

Syntaxe

HRESULT GetMaxLength(
  [out] LONG *pMaxLength
);

Paramètres

[out] pMaxLength

Pointeur vers une valeur de type LONG qui contient la longueur maximale autorisée pour les données de colonne. Cette fonction échoue si pMaxLength a la valeur NULL.

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK et pMaxLength est défini sur la longueur maximale autorisée pour les données de colonne.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

VB

La valeur de retour est la longueur maximale autorisée, en octets, pour les données de colonne.

Remarques

Cette méthode permet de déterminer la longueur maximale autorisée des données pour la colonne actuellement référencée par la séquence d’énumération de colonne.

Si la séquence d’énumération de colonne ne fait pas référence à une colonne valide, GetMaxLength échoue. Utilisez l’une des méthodes suivantes pour parcourir l’énumération :

IEnumCERTVIEWCOLUMN ::Reset : se déplace au début de la séquence d’énumération.
IEnumCERTVIEWCOLUMN ::Next : passe à la colonne suivante de la séquence d’énumération.
IEnumCERTVIEWCOLUMN ::Skip : ignore un nombre spécifié de colonnes.

Pour déterminer si les données de colonne sont indexées, appelez la méthode IEnumCERTVIEWCOLUMN ::IsIndexed .

Exemples

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certview.h (include Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certadm.dll