ICertServerExit::GetRequestAttribute-Methode (certif.h)
Die GetRequestAttribute-Methode gibt einen benannten Attributwert aus einer Anforderung zurück.
Vor dem Aufrufen dieser Methode muss ICertServerExit::SetContext aufgerufen werden.
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 gleich 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 ICertServerExit::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 ein Fehler diagnostiziert werden kann. |
Beispiele
BSTR bstrAttribValue = NULL;
HRESULT hr;
// Get the request attribute.
// bstrAttribName is a BSTR assigned by EnumerateAttributes.
// Also, ICertServerExit::SetContext has already been
// called by pCertServerExit.
hr = pCertServerExit->GetRequestAttribute(bstrAttribName,
&bstrAttribValue);
if (FAILED(hr))
{
printf("Failed GetRequestAttribute [%x]\n", hr);
goto error;
}
else
{
// Successful call. Use 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 |