ICertServerPolicy::GetRequestAttribute-Methode (certif.h)

  • Artikel

Die GetRequestAttribute-Methode gibt ein benanntes Attribut aus einer Anforderung zurück.

Syntax

HRESULT GetRequestAttribute(
  [in]  const BSTR strAttributeName,
  [out] BSTR       *pstrAttributeValue
);

Parameter

[in] strAttributeName

Der Name des abzurufenden Attributs.

[out] pstrAttributeValue

Ein Zeiger auf einen BSTR-Wert , der den Attributwert enthält.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und *pstrAttributeValue wird auf den BSTR festgelegt, der den Attributwert enthält.

Um diese Methode zu verwenden, erstellen Sie eine Variable vom Typ BSTR, legen Sie die Variable auf NULL fest, und übergeben Sie die Adresse dieser Variablen als pstrAttributeValue.

Wenn Sie die Verwendung des BSTR abgeschlossen haben, geben Sie ihn frei, indem Sie die SysFreeString-Funktion aufrufen.

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 den Attributwert darstellt.

Hinweise

Sie müssen ICertServerPolicy::SetContext aufrufen, bevor Sie diese Methode verwenden.

Die folgenden Anforderungsattribute sind für Anforderungen im KEYGEN-Stil eindeutig.

Eigenschaftenname type BESCHREIBUNG
Herausforderung String Anforderungszeichenfolge, die die Anforderung begleitet.
ExpectedChallenge String Wenn die Anforderungszeichenfolge falsch ist, legt der Server den Wert dieses Anforderungsattributs auf die erwartete Herausforderung fest, damit der Fehler diagnostiziert werden kann.
 

Beispiele

BSTR     bstrAttribValue = NULL;
HRESULT  hr;

// Get the request attribute.
// bstrAttribName is BSTR assigned by EnumerateAttributes.
// pCertServerPolicy has been used to call SetContext previously.
hr = pCertServerPolicy->GetRequestAttribute(bstrAttribName,
                                            &bstrAttribValue);

if (FAILED(hr))
{
    printf("Failed GetRequestAttribute [%x]\n", hr);
    goto error;
}
else
{

    // Successful call. Use the bstrAttribValue as needed.
    // ...
}

// Done processing. Free BSTR.
if (NULL != bstrAttribValue)
    SysFreeString(bstrAttribValue);

Anforderungen

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

Weitere Informationen

ICertServerPolicy

ICertServerPolicy::SetContext