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 (Cryptographic Service Provider, 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
Dieser Funktion ist keine Headerdatei oder Importbibliothek zugeordnet. Um diese Funktion aufzurufen, müssen Sie eine benutzerdefinierte Headerdatei erstellen und die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch eine Verknüpfung mit Mssign32.dll herzustellen.
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 abzurufende 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 bezogen hat.
-
ppwszTmpContainer [ out, optional]
-
Die Adresse eines Zeigers auf eine auf NULL endende Zeichenfolge für den Namen des temporären Schlüsselcontainers. Die GetCryptProvFromCert-Funktion stellt den temporären Container bereit und initialisiert sie. Beim Aufrufen von GetCryptProvFromCert sollte die Adresse auf einen NULL-Wert verweisen.
-
ppwszProviderName [ out, optional]
-
Die Adresse eines Zeigers auf eine auf 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 0 (null) oder einer der Kryptografieanbietertypen sein. Wenn dieser Member 0 (null) ist, ist der Schlüsselcontainer einer der CNG-Schlüsselspeicheranbieter.
Rückgabewert
Bei Erfolg gibt diese Funktion TRUE zurück. Die GetCryptProvFromCert-Funktion gibt FALSE zurück, wenn sie fehlschlägt.
Hinweise
Das MakeCert-Tool ruft GetCryptProvFromCert auf, wenn Sie es mithilfe der Befehlszeilenoption -is aufrufen.
Wenn der pfDidCryptAcquire-Parameter auf TRUE festgelegt ist, legt die Funktion die Parameter phCryptProv, pdwKeySpec und pdwProviderType auf die Anbieterwerte fest.
Wenn Sie den CSP nicht mehr verwenden, können Sie ihn freigeben, indem Sie die FreeCryptProvFromCert-Funktion aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| DLL |
|