IEnumCERTVIEWCOLUMN::GetValue-Methode (certview.h)

Artikel
02/23/2024

Die GetValue-Methode ruft den Datenwert ab, der in der aktuellen Spalte in der Spaltenaufzählungssequenz enthalten ist.

Syntax

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

Parameter

[in] Flags

Ein Bezeichner, der das Ausgabeformat für die abgerufenen Daten angibt. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
CV_OUT_BASE64	BASE64 ohne BEGIN/END
CV_OUT_BASE64HEADER	BASE64 mit BEGIN CERTIFICATE und END CERTIFICATE
CV_OUT_BASE64REQUESTHEADER	BASE64 mit BEGIN NEW CERTIFICATE REQUEST und END NEW CERTIFICATE REQUEST
CV_OUT_BASE64X509CRLHEADER	BASE64 mit BEGIN X509 CRL und END X509 CRL
CV_OUT_BINARY	Binary
CV_OUT_HEX	Hexadezimale Zeichenfolge
CV_OUT_HEXADDR	Hexadezimalzeichenfolge mit Adresse/Offset
CV_OUT_HEXASCII	Hexadezimalzeichenfolge mit ASCII
CV_OUT_HEXASCIIADDR	Hexadezimalzeichenfolge mit ASCII und Adresse/Offset

[out] pvarValue

Ein Zeiger auf den Wert des VARIANT-Typs , der die Datenspalte enthält. Diese Methode schlägt fehl, wenn pvarValueNULL ist. Nach erfolgreichem Abschluss dieser Methode enthält pvarValue die Daten in der Spalte. Der Aufrufer ist für den Aufruf von VariantClear verantwortlich, wenn er mit diesen Daten fertig ist.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück.

Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

VB

Der Rückgabewert ist ein Variant-Wert , der die Daten in der Spalte darstellt.

Hinweise

Diese Methode wird verwendet, um die Daten in der Spalte abzurufen, auf die derzeit von der Spaltenaufzählungssequenz verwiesen wird.

Wenn die Spaltenaufzählungssequenz nicht auf eine gültige Spalte verweist, schlägt GetValue fehl. Verwenden Sie eine der folgenden Methoden, um durch die Enumeration zu navigieren:

IEnumCERTVIEWCOLUMN::Reset: Wird an den Anfang der Enumerationssequenz verschoben.
IEnumCERTVIEWCOLUMN::Next: Wechselt zur nächsten Spalte in der Enumerationssequenz.
IEnumCERTVIEWCOLUMN::Skip: Überspringt eine angegebene Anzahl von Spalten.

Beispiele

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certview.h (include Certsrv.h)
Bibliothek	Certidl.lib
DLL	Certadm.dll