PvkGetCryptProv-Funktion

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) basierend auf einer Datei mit einem privaten Schlüssel oder einem Schlüsselcontainernamen ab.

Hinweis

Dieser Funktion ist keine Headerdatei oder Importbibliothek zugeordnet. Zum Aufrufen dieser Funktion müssen Sie eine benutzerdefinierte Headerdatei erstellen und die Funktionen LoadLibrary und GetProcAddress verwenden, um eine dynamische Verknüpfung mit Mssign32.dll.

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 Dialogfelds "Kennwort". andernfalls ist es NULL.

pwszCaption [ In]

Ein Zeiger auf eine auf NULL beendete Zeichenfolge für die Beschriftung des Dialogfelds.

pwszCapiProvider [ In]

Ein Zeiger auf eine auf NULL beendete 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 auf NULL beendete Zeichenfolge, die den Namen einer Datei mit privatem Schlüssel enthält.

pwszKeyContainerName [ In]

Ein Zeiger auf eine auf NULL beendete 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 auf NULL beendete Zeichenfolge für den temporären Schlüsselcontainernamen. Die PvkGetCryptProv-Funktion stellt den temporären Container zur Und initialisiert den Container. 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 bei der Methode ein Fehler auftritt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Eine Liste der allgemeinen Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Hinweise

Die PvkGetCryptProv-Funktion versucht zunächst, das Anbieterhandle aus dem Schlüsselcontainernamen zu erhalten, der durch den pwszKeyContainerName-Parameter angegeben wird. Wenn Sie NULL für den pwszKeyContainerName-Parameter übergeben, versucht PvkGetCryptProv, den Anbieter aus der datei mit dem privaten Schlüssel zu erhalten, die im pwszPvkFile-Parameter angegeben ist.

Wenn Sie die Verwendung des CSP abgeschlossen haben, geben Sie das Anbieterhandler und den temporären Schlüsselcontainer frei, indem Sie die PvkFreeCryptProv-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
Mssign32.dll