PvkPrivateKeyAcquireContextFromMemory-Funktion

Artikel
06/13/2023

Wichtig

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

Die PvkPrivateKeyAcquireContextFromMemory-Funktion erstellt einen temporären Container im Kryptografiedienstanbieter (Cryptographic Service Provider , CSP) und lädt einen privaten Schlüssel aus dem Arbeitsspeicher in den Container.

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 PvkPrivateKeyAcquireContextFromMemory(
  _In_        LPCWSTR    pwszProvName,
  _In_        DWORD      dwProvType,
  _In_        BYTE       *pbData,
  _In_        DWORD      cbData,
  _In_        HWND       hwndOwner,
  _In_        LPCWSTR    pwszKeyName,
  _Inout_opt_ DWORD      *pdwKeySpec,
  _Out_       HCRYPTPROV *phCryptProv,
  _Out_       LPTSTR     *ppwszTmpContainer
);

Parameter

pwszProvName [in]: Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des CSP enthält, dessen Typ in dwProvType angefordert wird.
dwProvType [in]: Ein DWORD-Wert für den CSP-Typ. Weitere Informationen zu CSP-Typen finden Sie unter Kryptografieanbietertypen.
pbData [in]: Ein Zeiger auf einen Puffer zum Empfangen der Kontextdaten. Der Aufrufer muss diese Ressource bereitstellen.
cbData [in]: Ein DWORD-Wert , der die Größe des pbData-Puffers in Bytes angibt. Der Aufrufer muss diesen Wert angeben.
hwndOwner [in]: Wenn zum Entschlüsseln der Kontextdaten, auf die der pbData-Parameter verweist, ein Kennwort erforderlich ist, ist dieser Parameter ein Handle für das übergeordnete Element des Dialogfelds. Andernfalls ist es NULL.
pwszKeyName [in]: Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des abzurufenden Schlüssels enthält.
pdwKeySpec [in, out, optional]: Ein Zeiger auf einen DWORD-Wert , der den Schlüsseltyp angibt. Mögliche Werte sind AT_KEYEXCHANGE oder AT_SIGNATURE.
phCryptProv [out]: Ein Zeiger auf ein Handle für den CSP.
ppwszTmpContainer [out]: Die Adresse eines Zeigers auf eine NULL-endende Zeichenfolge für den namen des temporären Containers. Die PvkPrivateKeyAcquireContextFromMemory-Funktion stellt den Puffer für diese Zeichenfolge bereit und initialisiert ihn. Beim Aufrufen von PvkPrivateKeyAcquireContextFromMemory sollte die Adresse auf einen NULL-Wert verweisen.

Rückgabewert

Bei erfolgreicher Ausführung gibt diese Funktion TRUE zurück. Die PvkPrivateKeyAcquireContextFromMemory-Funktion gibt FALSE zurück, wenn sie fehlschlägt.

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

Share via