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
Mssign32.dll