PvkGetCryptProv-Funktion

Artikel
06/13/2023

Wichtig

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

Die PvkGetCryptProv-Funktion ruft ein Handle für einen Kryptografiedienstanbieter (Cryptographic Service Provider , CSP) ab, der entweder auf einer Datei mit privatem Schlüssel oder einem Schlüsselcontainernamen basiert.

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

HRESULT WINAPI PvkGetCryptProv(
  _In_      HWND       hwnd,
  _In_      LPCWSTR    pwszCaption,
  _In_      LPCWSTR    pwszCapiProvider,
  _In_      DWORD      dwProviderType,
  _In_      LPCWSTR    pwszPvkFile,
  _In_      LPCWSTR    pwszKeyContainerName,
  _Out_     DWORD      *pdwKeySpec,
  _Out_opt_ LPWSTR     *ppwszTmpContainer,
  _Out_     HCRYPTPROV *phCryptProv
);

Parameter

hwnd [in]: Wenn zum Entschlüsseln der Datei mit dem privaten Schlüssel ein Kennwort erforderlich ist, ist dieser Parameter ein Handle für das übergeordnete Element des Kennwortdialogfelds. Andernfalls ist es NULL.
pwszCaption [in]: Ein Zeiger auf eine NULL-endende Zeichenfolge für das Dialogfeld Untertitel.
pwszCapiProvider [in]: Ein Zeiger auf eine NULL-endende Zeichenfolge für den CSP-Namen.
dwProviderType [in]: Ein DWORD-Wert , der den Kryptografieanbietertyp darstellt. Weitere Informationen finden Sie unter Kryptografieanbietertypen.
pwszPvkFile [in]: Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen einer Datei mit privatem Schlüssel enthält.
pwszKeyContainerName [in]: Ein Zeiger auf eine NULL-endende Zeichenfolge für den Containernamen des privaten Schlüssels.
pdwKeySpec [out]: Ein Zeiger auf einen DWORD-Wert für den Schlüsseltyp des Containers, der mit phCryptProv und ppwszTmpContainer zurückgegeben wird.
ppwszTmpContainer [out, optional]: Die Adresse eines Zeigers auf eine NULL-endende Zeichenfolge für den Containernamen des temporären Schlüssels. Die PvkGetCryptProv-Funktion stellt den temporären Container bereit und initialisiert diesen. Beim Aufrufen von PvkGetCryptProv sollte die Adresse auf einen NULL-Wert verweisen.
phCryptProv [out]: Ein Zeiger auf ein Handle für den CSP.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben.

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.

Bemerkungen

Die PvkGetCryptProv-Funktion versucht zunächst, das Anbieterhandle aus dem Schlüsselcontainernamen abzurufen, der durch den parameter pwszKeyContainerName angegeben wird. Wenn Sie NULL für den Parameter pwszKeyContainerName übergeben, versucht PvkGetCryptProv , den Anbieter aus der im parameter pwszPvkFile angegebenen Privaten Schlüsseldatei abzurufen.

Wenn Sie die Verwendung des CSP abgeschlossen haben, geben Sie das Anbieterhandle und den Container für temporäre Schlüssel frei, indem Sie die PvkFreeCryptProv-Funktion 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