ICertServerPolicy::GetRequestProperty-Methode (certif.h)
Die GetRequestProperty-Methode ruft eine bestimmte Eigenschaft aus einer Anforderung ab.
Syntax
HRESULT GetRequestProperty(
[in] const BSTR strPropertyName,
[in] LONG PropertyType,
[out] VARIANT *pvarPropertyValue
);
Parameter
[in] strPropertyName
Gibt den Namen der abzurufenden Eigenschaft an. Dieser Parameter kann auf eine name-Eigenschaft oder eine Anforderungseigenschaft festgelegt werden.
Namenseigenschaften enthalten einen Stammsatz von Zertifikateigenschaften, die immer gültig sind und durch Aufrufen dieser Methode abgerufen werden können. Informationen zu diesen Eigenschaften finden Sie unter Namenseigenschaften.
Anforderungseigenschaften sind für Anforderungen eindeutig und enthalten die folgenden möglichen Werte.
Hinweis Es gibt zusätzliche Anforderungseigenschaften, auf die getRequestProperty nicht zugegriffen werden kann, da sie erst festgelegt werden, nachdem das Richtlinienmodul die Verarbeitung der Anforderung abgeschlossen hat. Darüber hinaus können andere Eigenschaften durch einen bestimmten Anforderungstyp, Anforderungserweiterungen oder durch benannte Attribute festgelegt werden, die im Header einer Anforderung festgelegt sind.
[in] PropertyType
Gibt den Eigenschaftentyp an. Der PropertyType-Parameter kann einer der folgenden Typen sein.
| Wert | Bedeutung |
|---|---|
|
Signierte lange Daten. |
|
Datum/Uhrzeit. |
|
Binärdaten. |
|
Unicode-Zeichenfolgendaten . |
[out] pvarPropertyValue
Ein Zeiger auf den VARIANT,der den Anforderungseigenschaftentyp enthält.
Rückgabewert
C++
Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und der pvarPropertyValue-Parameter enthält die Anforderungseigenschaft.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 die Anforderungseigenschaft.Hinweise
Die SetContext-Methode muss vor dem Aufrufen dieser Methode aufgerufen werden. Der Aufruf von SetContext gibt an, welche Anforderung als aktueller Kontext verwendet wird.
Anforderungen enthalten alle zugeordneten Zustände für die Anforderung und das letztendlich erteilte Zertifikat, das nicht Teil des Zertifikats ist. Daher werden Daten wie Widerrufszeiten und Dispositionsdaten im Anforderungsdatenobjekt gespeichert.
Die RequestType-Eigenschaft kann auf einen der folgenden Werte festgelegt werden.
| Wert | Bedeutung |
|---|---|
| CR_IN_PKCS | Die Anforderung ist eine PKCS #7-Verlängerungs- oder Registrierungsanforderung. |
| CR_IN-PKCS10 | Die Anforderung ist eine PKCS #10-Anforderung. |
| CR_IN_KEYGEN | Die Anforderung ist eine Keygen-Anforderung (Netscape-Format). |
Beispiele
BSTR bstrPropName = NULL;
VARIANT varProp;
VariantInit( &varProp );
bstrPropName = SysAllocString(L"RequestID");
// Retrieve the request property.
// pCertServerPolicy has been used to call SetContext previously.
hr = pCertServerPolicy->GetRequestProperty( bstrPropName,
PROPTYPE_LONG,
&varProp );
if (FAILED(hr))
{
printf("Failed GetRequestProperty [%x]\n", hr);
goto error;
}
else
{
// Successfully retrieved property; use varProp as needed.
// ...
}
// Done processing.
VariantClear( &varProp );
if ( NULL != bstrPropName )
SysFreeString( bstrPropName );
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 |