ICertConfig::GetField-Methode (certcli.h)

  • Artikel

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