GetCryptProvFromCert-Funktion

Artikel
06/13/2023

Wichtig

Diese API ist veraltet. Microsoft kann diese API in zukünftigen Versionen entfernen.

Die GetCryptProvFromCert-Funktion ruft ein Handle für einen Kryptografiedienstanbieter (CSP ) und eine Schlüsselspezifikation für einen Zertifikatkontext ab. Verwenden Sie diese Funktion, um Zugriff auf den privaten Schlüssel des Zertifikatausstellers zu erhalten.

Hinweis

Diese Funktion verfügt über keine zugeordnete Headerdatei oder Importbibliothek. Um diese Funktion aufzurufen, müssen Sie eine benutzerdefinierte Headerdatei erstellen und die Funktionen LoadLibrary und GetProcAddress zum dynamischen Verknüpfen mit Mssign32.dll verwenden.

Syntax

BOOL WINAPI GetCryptProvFromCert(
  _In_      HWND           hwnd,
  _In_      PCCERT_CONTEXT pCert,
  _Out_     HCRYPTPROV     *phCryptProv,
  _Out_     DWORD          *pdwKeySpec,
  _In_      BOOL           *pfDidCryptAcquire,
  _Out_opt_ LPWSTR         *ppwszTmpContainer,
  _Out_opt_ LPWSTR         *ppwszProviderName,
  _Out_     DWORD          *pdwProviderType
);

Parameter

hwnd [in]: Das Handle des Fensters, das als Besitzer aller angezeigten Dialogfelder verwendet werden soll. Dieser Member wird derzeit nicht verwendet und ignoriert. Es ist sicher, NULL für diesen Parameter zu übergeben.
pCert [in]: Ein Zeiger auf eine CERT_CONTEXT-Struktur für das Zertifikat.
phCryptProv [out]: Ein Zeiger auf eine HCRYPTPROV-Struktur , die ein Handle für den CSP ist.
pdwKeySpec [out]: Die Spezifikation des abzurufenden privaten Schlüssels. Mögliche Werte sind AT_KEYEXCHANGE oder AT_SIGNATURE.
pfDidCryptAcquire [in]: Ein -Wert, der angibt, ob die Funktion das Anbieterhandle basierend auf dem Zertifikat abgerufen hat.
ppwszTmpContainer [out, optional]: Die Adresse eines Zeigers auf eine NULL-endende Zeichenfolge für den Containernamen des temporären Schlüssels. Die GetCryptProvFromCert-Funktion stellt den temporären Container bereit und initialisiert diesen. Beim Aufrufen von GetCryptProvFromCert sollte die Adresse auf einen NULL-Wert verweisen.
ppwszProviderName [out, optional]: Die Adresse eines Zeigers auf eine NULL-endende Zeichenfolge für den Anbieternamen. Die GetCryptProvFromCert-Funktion gibt den Anbieternamen zurück. Beim Aufrufen von GetCryptProvFromCert sollte die Adresse auf einen NULL-Wert verweisen.
pdwProviderType [out]: Gibt den CSP-Typ an. Dies kann null oder einer der Kryptografieanbietertypen sein. Wenn dieser Member null ist, ist der Schlüsselcontainer einer der CNG-Schlüsselspeicheranbieter.

Rückgabewert

Bei erfolgreicher Ausführung gibt diese Funktion TRUE zurück. Die GetCryptProvFromCert-Funktion gibt FALSE zurück, wenn ein Fehler auftritt.

Bemerkungen

Das MakeCert-Tool ruft GetCryptProvFromCert auf, wenn Sie es mit der Befehlszeilenoption -is aufrufen.

Wenn der Parameter pfDidCryptAcquire auf TRUE festgelegt ist, legt die Funktion die Parameter phCryptProv, pdwKeySpec und pdwProviderType auf die Anbieterwerte fest.

Wenn Sie die Verwendung des CSP abgeschlossen haben, geben Sie ihn frei, indem Sie die Funktion FreeCryptProvFromCert aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
DLL	Mssign32.dll

Freigeben über