ICertRequest2::GetFullResponseProperty-Methode (certcli.h)

Artikel
08/22/2023

Die GetFullResponseProperty-Methode ruft die vom Server zurückgegebenen zwischengespeicherten Antwortdaten ab.

Syntax

HRESULT GetFullResponseProperty(
  [in]  LONG    PropId,
  [in]  LONG    PropIndex,
  [in]  LONG    PropType,
  [in]  LONG    Flags,
  [out] VARIANT *pvarPropertyValue
);

Parameter

[in] PropId

Die abzurufenden Daten. Wenn die Eigenschaft indiziert ist, verwenden Sie PropIndex , um den Index anzugeben. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
FR_PROP_NONE 0	Keine Daten.
FR_PROP_FULLRESPONSE 1	Alle zwischengespeicherten Daten werden abgerufen (Binärdaten).
FR_PROP_STATUSINFOCOUNT 2	Die Anzahl der Antworten in Cachedaten (long, indizierte Eigenschaft).
FR_PROP_BODYPARTSTRING 3	Hierarchiedaten (Zeichenfolge, indizierte Eigenschaft).
FR_PROP_STATUS 4	Die Anforderung status Wert (long, indizierte Eigenschaft).
FR_PROP_STATUSSTRING 5	Die Anforderung status Zeichenfolge (Zeichenfolge, indizierte Eigenschaft).
FR_PROP_OTHERINFOCHOICE 6	Auswahl für andere Informationen (long, indizierte Eigenschaft). Dies kann einer der folgenden Werte sein. CMC_OTHER_INFO_NO_CHOICE CMC_OTHER_INFO_FAIL_CHOICE CMC_OTHER_INFO_PEND_CHOICE
FR_PROP_FAILINFO 7	Die Anforderungsfehlerinformationen (long, indizierte Eigenschaft).
FR_PROP_PENDINFOTOKEN 8	Das ausstehende Anforderungstoken (binär, indizierte Eigenschaft).
FR_PROP_PENDINFOTIME 9	Das ausstehende Anforderungsdatum (DATE, indizierte Eigenschaft).
FR_PROP_ISSUEDCERTIFICATEHASH 10	Der Hash des ausgestellten Zertifikats wird abgerufen (binär, indizierte Eigenschaft).
FR_PROP_ISSUEDCERTIFICATE 11	Das ausgestellte Zertifikat wird abgerufen (binär, indizierte Eigenschaft).
FR_PROP_ISSUEDCERTIFICATECHAIN 12	Das ausgestellte Zertifikat (binär, indizierte Eigenschaft).
FR_PROP_ISSUEDCERTIFICATECRLCHAIN 13	Die ausgestellte Zertifikatkette (binär, indizierte Eigenschaft).
FR_PROP_ENCRYPTEDKEYHASH 14	Der verschlüsselte Schlüsselhash (binär, indizierte Eigenschaft).
FR_PROP_FULLRESPONSENOPKCS7 15	Alle zwischengespeicherten Daten werden mit Ausnahme von PKCS #7 (binär) abgerufen.
FR_PROP_CAEXCHANGECERTIFICATEHASH 16	Der Zertifikathash der Zertifizierungsstelle.
FR_PROP_CAEXCHANGECERTIFICATE 17	Das Zertifizierungsstellen-Austauschzertifikat.
FR_PROP_CAEXCHANGECERTIFICATECHAIN 18	Die Zertifikatkette der Zertifizierungsstelle.
FR_PROP_CAEXCHANGECERTIFICATECRLCHAIN 19	Die ZERTIFIKAT-CLR-Kette der Zertifizierungsstelle.
FR_PROP_ATTESTATIONCHALLENGE 20	Antwort auf die Schlüsselnachweisanforderung
FR_PROP_ATTESTATIONPROVIDERNAME 21	Der Name des Schlüsselspeicheranbieters für den Schlüsselnachweis.

[in] PropIndex

Der nullbasierte Index, wenn PropId eine indizierte Eigenschaft ist. Wenn PropId keine indizierte Eigenschaft ist, muss PropIndex null sein.

[in] PropType

Der Typ der in pvarPropertyValue zurückgegebenen Daten. Der Eigenschaftentyp hier muss mit dem Datentyp übereinstimmen, der vom PropId-Parameter angegeben wird.

Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
PROPTYPE_LONG 1	Signierte lange Daten.
PROPTYPE_DATE 2	Datumsdaten (einschließlich Datum und Uhrzeit).
PROPTYPE_BINARY 3	Binärdaten.
PROPTYPE_STRING 4	Zeichenfolgendaten.

[in] Flags

Das Format der in pvarPropertyValue zurückgegebenen Daten. Das hier festgelegte Flag muss mit dem Datentyp übereinstimmen, der vom PropId-Parameter angegeben wird.

Weitere Informationen finden Sie in den Hinweisen. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
CR_OUT_BASE64HEADER 0	BASE64-Format mit Begin/End-Header.
CR_OUT_BASE64 1	BASE64-Format ohne Begin/End-Header.
CR_OUT_BINARY 2	Binärformat.

[out] pvarPropertyValue

Die zurückgegebenen Daten.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und pvarPropertyValue enthält die zurückgegebenen Daten.

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 ein Variant-Wert , der die zurückgegebenen Daten enthält.

Hinweise

Die folgenden PropId-Werte geben Binärdaten zurück, was bedeutet, dass der Flags-Parameter auf CR_OUT_BINARY festgelegt werden muss:

FR_PROP_FULLRESPONSE
FR_PROP_ISSUEDCERTIFICATEHASH
FR_PROP_ISSUEDCERTIFICATE
FR_PROP_ISSUEDCERTIFICATECHAIN
FR_PROP_ISSUEDCERTIFICATECRLCHAIN
FR_PROP_ENCRYPTEDKYEHASH
FR_PROP_FULLRESPONSENOPKCS7

Diese Methode wird aufgerufen, nachdem die Methoden ICertRequest3::Submit oder ICertRequest3::RetrievePending aufgerufen wurden. Diese Methoden füllen die zwischengespeicherten Daten auf, die von GetFullResponseProperty zurückgegeben werden.

Nachdem die ICertRequest3::GetFullResponseProperty-Methode ihre Daten zurückgegeben hat, können die folgenden Methoden aufgerufen werden:

ICEnroll4::AcceptResponse kann aufgerufen werden, um das zurückgegebene Zertifikat zu installieren.
ICEnroll4::GetCertFromResponse kann aufgerufen werden, um das Zertifikat aus der Antwort zu analysieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certcli.h (certsrv.h einschließen)
Bibliothek	Certidl.lib
DLL	Certcli.dll

Share via