CertGetServerOcspResponseContext-Funktion (wincrypt.h)

Artikel
08/27/2023

Die CertGetServerOcspResponseContext-Funktion ruft einen nicht blockierenden, zeit gültigen OcSP-Antwortkontext (Online certificate status Protocol) für das angegebene Handle ab.

Syntax

PCCERT_SERVER_OCSP_RESPONSE_CONTEXT CertGetServerOcspResponseContext(
  [in] HCERT_SERVER_OCSP_RESPONSE hServerOcspResponse,
  [in] DWORD                      dwFlags,
       LPVOID                     pvReserved
);

Parameter

[in] hServerOcspResponse

Das OCSP-Serverantworthandle, für das ein Antwortkontext abgerufen werden soll. Dieses Handle wird von der CertOpenServerOcspResponse-Funktion zurückgegeben.

[in] dwFlags

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss null sein.

pvReserved

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss NULL sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ein Zeiger auf eine CERT_SERVER_OCSP_RESPONSE_CONTEXT-Struktur zurückgegeben.

Damit eine Antwort gültig ist, muss die aktuelle Zeit auf dem System, das diesen Funktionsaufruf hostt, kleiner sein als die nächste Aktualisierungszeit für den Kontext der Zertifikatsperrliste (Certificate Revocation List , CRL). Wenn keine gültige OCSP-Antwort verfügbar ist, gibt diese Funktion NULL zurück, wobei der letzte Fehler auf CRYPT_E_REVOCATION_OFFLINE festgelegt ist.

Wenn das Zertifikat vom OCSP-Responder unbekannt ist, gibt diese Funktion NULL zurück, wobei der letzte Fehler auf CRYPT_E_REVOCATION_OFFLINE festgelegt ist.

Hinweise

Wenn Sie die CertGetServerOcspResponseContext-Funktion verwenden, um mehrere Verweise auf einen OCSP-Antwortkontext zu erstellen, müssen Sie CertAddRefServerOcspResponseContext aufrufen, um die Verweisanzahl für die CERT_SERVER_OCSP_RESPONSE_CONTEXT-Struktur zu erhöhen. Wenn Sie die Verwendung der -Struktur abgeschlossen haben, müssen Sie sie freigeben, indem Sie die CertFreeServerOcspResponseContext-Funktion aufrufen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wincrypt.h
Bibliothek	Crypt32.lib
DLL	Crypt32.dll

Freigeben über