ICertServerPolicy::GetRequestProperty-Methode (certif.h)

Artikel
08/22/2023

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.

Wert	Bedeutung
RequestID Lange signiert	Interne Anforderungs-ID.
RawRequest Binary	Unformatierte Anforderungsbytes.
RequestAttributes String	Attributzeichenfolge (kann abgeschnitten werden).
Requesttype Lange signiert	Gibt PKCS #10 oder KeyGen-Anforderung an. Weitere Informationen zu dieser Eigenschaft finden Sie unter Hinweise.
SubmittedWhen Datum/Uhrzeit	Wenn sie angekommen sind.
RequesterName String	Der Name des Anfordernden im Format "Domänenname\UserID".

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
PROPTYPE_LONG	Signierte lange Daten.
PROPTYPE_DATE	Datum/Uhrzeit.
PROPTYPE_BINARY	Binärdaten.
PROPTYPE_STRING	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