IEnumCERTVIEWCOLUMN ::GetValue, méthode (certview.h)

Article
02/26/2024

La méthode GetValue récupère la valeur de données contenue dans la colonne active dans la séquence d’énumération de colonnes.

Syntaxe

HRESULT GetValue(
  [in]  LONG    Flags,
  [out] VARIANT *pvarValue
);

Paramètres

[in] Flags

Identificateur qui indique le format de sortie pour les données récupérées. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
CV_OUT_BASE64	BASE64 sans BEGIN/END
CV_OUT_BASE64HEADER	BASE64 avec BEGIN CERTIFICATE et END CERTIFICATE
CV_OUT_BASE64REQUESTHEADER	BASE64 avec BEGIN NEW CERTIFICATE REQUEST et END NEW CERTIFICATE REQUEST
CV_OUT_BASE64X509CRLHEADER	BASE64 avec BEGIN X509 CRL et END X509 CRL
CV_OUT_BINARY	Binary
CV_OUT_HEX	Chaîne hexadécimale
CV_OUT_HEXADDR	Chaîne hexadécimale avec adresse/décalage
CV_OUT_HEXASCII	Chaîne hexadécimale avec ASCII
CV_OUT_HEXASCIIADDR	Chaîne hexadécimale avec ASCII et address/offset

[out] pvarValue

Pointeur vers la valeur de type VARIANT qui contient la colonne de données. Cette méthode échoue si pvarValue a la valeur NULL. Une fois cette méthode terminée, pvarValue contient les données dans la colonne . L’appelant est chargé d’appeler VariantClear quand vous avez terminé avec ces données.

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK.

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 un variant qui représente les données dans la colonne.

Remarques

Cette méthode est utilisée pour récupérer les données dans la colonne actuellement référencée par la séquence d’énumération de colonnes.

Si la séquence d’énumération de colonne ne fait pas référence à une colonne valide, GetValue é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.

Exemples

HRESULT     hr;
VARIANT     var;
SYSTEMTIME  systime;

VariantInit(&var);

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
hr = pEnumCol->GetValue(CV_OUT_HEX, &var);
if ( FAILED (hr) )
{
    printf("Failed GetValue - %x\n", hr);
    goto error;
}
switch( var.vt )
{
    case VT_EMPTY:
        printf( "VT_EMPTY\n" );
        break;
    case VT_BSTR:
        printf("%ws\n", var.bstrVal );
        break;
    case VT_DATE:
        VariantTimeToSystemTime( var.date, &systime );
        printf("%d.%d.%d %02d:%02d:%02d\n",
               systime.wMonth,
               systime.wDay,
               systime.wYear,
               systime.wHour,
               systime.wMinute,
               systime.wSecond );
        break;
    case VT_I2:
        printf("%d\n", var.iVal );
        break;
    case VT_I4:
        printf("%d\n", var.lVal );
        break;
    default:
        printf("type is:%i\n", var.vt );
        break;
}
// done processing, clear resources
VariantClear( &var );

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