PvkPrivateKeySave-Funktion

Wichtig

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

 

Die PvkPrivateKeySave-Funktion speichert einen privaten Schlüssel und den entsprechenden öffentlichen Schlüssel in einer angegebenen Datei.

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 PvkPrivateKeySave(
  _In_ HCRYPTPROV hCryptProv,
  _In_ HANDLE     hFile,
  _In_ DWORD      dwKeySpec,
  _In_ HWND       hwndOwner,
  _In_ LPCWSTR    pwszKeyName,
  _In_ DWORD      dwFlags
);

Parameter

hCryptProv [in]

Ein Handle für einen Kryptografiedienstanbieter (Cryptographic Service Provider , CSP).

hFile [in]

Ein Handle für eine Datei, die mit anfänglicher Lese-/Schreibberechtigung und anschließender schreibgeschützter Berechtigung erstellt wurde.

dwKeySpec [in]

Eine lange ganze Zahl für den Schlüsseltyp. Mögliche Werte sind AT_KEYEXCHANGE oder AT_SIGNATURE.

hwndOwner [in]

Wenn zum Verschlüsseln des privaten Schlüssels 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 für den Namen des zu speichernden Schlüssels.

dwFlags [in]

Ein DWORD-Wert , der zusätzliche Optionen für die Funktion angibt. Weitere Informationen finden Sie unter dem dwFlags-Parameter in CryptExportKey.

Rückgabewert

Bei erfolgreicher Ausführung gibt diese Funktion TRUE zurück. Die PvkPrivateKeySave-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