GetCryptProvFromCert-Funktion
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 |
|