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
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 |
|