PvkPrivateKeyAcquireContextFromMemory-Funktion
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
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 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 auf 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, um die Kontextdaten zu empfangen. 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 auf NULL endende Zeichenfolge, die den Namen des abzurufenden Schlüssels enthält.
-
pdwKeySpec [ in, out, optional]
-
Ein Zeiger auf einen DWORD-Wert, der den Typ des Schlüssels 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 auf NULL endende Zeichenfolge für den temporären Containernamen. Die PvkPrivateKeyAcquireContextFromMemory-Funktion stellt den Puffer für diese Zeichenfolge bereit und initialisiert sie. Beim Aufrufen von PvkPrivateKeyAcquireContextFromMemory sollte die Adresse auf einen NULL-Wert verweisen.
Rückgabewert
Bei Erfolg 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 [Nur XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| DLL |
|