ICertServerPolicy::GetRequestAttribute-Methode (certif.h)
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 |