ICertConfig::GetField-Methode (certcli.h)

Artikel
08/22/2023

Die GetField-Methode ruft ein bestimmtes Feld aus dem aktuellen Datensatz der Konfigurationsdatenbank ab. Diese Methode wurde zuerst in der ICertConfig-Schnittstelle definiert.

Syntax

HRESULT GetField(
  [in]          const BSTR strFieldName,
  [out, retval] BSTR       *pstrOut
);

Parameter

[in] strFieldName

Gibt den Namen des zurückzugebenden Felds an. Dieser Parameter kann eine der folgenden gültigen Zeichenfolgen für Feldnamen sein (beachten Sie, dass einige Zertifizierungsstellen möglicherweise keine Daten für jedes Feld bereitstellen).

Wert	Bedeutung
Autoritative Stelle	Verweisen Sie auf den Namen der Zertifizierungsstelle (Ca).
CommonName	Allgemeiner Name des Servers.
Konfiguration	Verweisen Sie auf computer\CA-Name.
Country	Land/Region
Beschreibung	Beschreibender Kommentar zum Server (ersetzt den veralteten "Kommentar").
Exchangecertificate	Name der Datei, die das Exchange-Zertifikat enthält (gilt nur für Zertifikatdienste 1.0).
Flags	Zeichenfolge, die den Speicherort darstellt, an dem die Informationen der Zertifizierungsstelle gefunden wurden. Weitere Informationen finden Sie in den Hinweisen.
Lokalität	Stadt oder Ort.
Organisation	Organisation.
OrgUnit	Organisationseinheit
SanitizedName	Zertifizierungsstellenname, der gemäß den in GetConfig beschriebenen Regeln bereinigung wird.
SanitizedShortName	Zertifizierungsstellenname, der gemäß den in GetConfig beschriebenen Regeln bereinigungs- und verkürzt wird.
Server	Verweisen Sie auf den Computernamen.
ShortName	SanitizedShortName, aber mit den '!xxx'-Sequenzen, wie in GetConfig beschrieben, zurück in den ursprünglichen Text übersetzt.
SignatureCertificate	Name der Datei, die das Zertifizierungsstellenzertifikat (auch als Signaturzertifikat der Zertifizierungsstelle bezeichnet) enthält; Dies kann ein Stammzertifikat sein oder nicht.
State	Bundesland oder Provinz.
WebEnrollmentServers	Ein Array von Zertifikatregistrierungswebdienst-URLs für eine bestimmte Zertifizierungsstellenkonfiguration in Active Directory. Windows Vista und Windows Storage Server 2003: Dieses Feld wird nicht unterstützt.

[out, retval] pstrOut

Ein Zeiger auf einen BSTR , der die Daten aus dem Feld empfängt. Wenn Sie die Verwendung von BSTR abgeschlossen haben, können Sie pbstrOut durch Aufrufen der SysFreeString-Funktion kostenlos nutzen.

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 eine Zeichenfolge, die die Daten für das Feld darstellt.

Hinweise

Diese Methode gibt die Felddaten für das angegebene Feld zurück.

Wenn Sie "Flags" im strFieldName-Parameter angeben, sind die abgerufenen Daten für das Feld flags eine Zeichenfolge, die mithilfe der C-library-Funktion _wtoi in eine ganze Zahl konvertiert werden kann. Die resultierende ganze Zahl stellt ein Bitfeld dar, das untersucht werden kann, um zu bestimmen, ob die Flags CAIF_DSENTRY und CAIF_SHAREDFOLDERENTRY festgelegt sind. Wenn CAIF_DSENTRY (0x00000001) festgelegt ist, wurden die Informationen für die Zertifizierungsstelle in Verzeichnisdienste enthalten. Wenn CAIF_SHAREDFOLDERENTRY (0x00000002) festgelegt ist, wurden die Informationen für die Zertifizierungsstelle im freigegebenen Ordner enthalten. Beachten Sie, dass eines oder beide dieser Flags festgelegt werden können.

Beispiele

    BSTR  bstrFieldName = NULL;
    BSTR  bstrFieldValue = NULL;
    HRESULT    hr;

    // Specify the field to retrieve, for example, "CommonName".
    bstrFieldName = SysAllocString(L"<FIELDNAMEHERE>");
    if (NULL == bstrFieldName)
    {
        printf("Memory allocation failed for bstrFieldName.\n");
        goto error;
    }

    // pConfig is a previously instantiated ICertConfig object.
    hr = pConfig->GetField(bstrFieldName, &bstrFieldValue);
    if (FAILED(hr))
    {
        printf("Failed GetField - [%x]\n", hr);
        goto error;
    }
    else
        printf("GetField value for %ws is: %ws\n", 
            bstrFieldName, bstrFieldValue );

error:

    if (bstrFieldName)
        SysFreeString(bstrFieldName);

    if (bstrFieldValue)
        SysFreeString(bstrFieldValue);

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certcli.h (certsrv.h einschließen)
Bibliothek	Certidl.lib
DLL	Certcli.dll

Weitere Informationen

CCertConfig

ICertConfig

Freigeben über