Fonction PvkPrivateKeySave

  • Article

Important

Cette API est déconseillée. Microsoft peut supprimer cette API dans les versions ultérieures.

 

La fonction PvkPrivateKeySave enregistre une clé privée et sa clé publique correspondante dans un fichier spécifié.

Notes

Cette fonction n’a pas de fichier d’en-tête associé ni de bibliothèque d’importation. Pour appeler cette fonction, vous devez créer un fichier d’en-tête défini par l’utilisateur et utiliser les fonctions LoadLibrary et GetProcAddress pour lier dynamiquement à Mssign32.dll.

 

Syntaxe

BOOL WINAPI PvkPrivateKeySave(
  _In_ HCRYPTPROV hCryptProv,
  _In_ HANDLE     hFile,
  _In_ DWORD      dwKeySpec,
  _In_ HWND       hwndOwner,
  _In_ LPCWSTR    pwszKeyName,
  _In_ DWORD      dwFlags
);

Paramètres

hCryptProv [in]

Handle à un fournisseur de services de chiffrement (CSP).

hFile [in]

Handle d’un fichier créé avec l’autorisation de lecture/écriture initiale et l’autorisation en lecture seule ultérieure.

dwKeySpec [in]

Entier long pour le type de clé. Les valeurs possibles incluent AT_KEYEXCHANGE ou AT_SIGNATURE.

hwndOwner [in]

Si un mot de passe est nécessaire pour chiffrer la clé privée, ce paramètre est un handle pour le parent de la boîte de dialogue ; sinon, elle est NULL.

pwszKeyName [in]

Pointeur vers une chaîne terminée par null pour le nom de la clé à enregistrer.

dwFlags [in]

Valeur DWORD qui spécifie des options supplémentaires pour la fonction. Pour plus d’informations, consultez le paramètre dwFlags dans CryptExportKey.

Valeur retournée

En cas de réussite, cette fonction retourne TRUE. La fonction PvkPrivateKeySave retourne FALSE en cas d’échec.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
 Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows Server 2003 [applications de bureau uniquement]
DLL
Mssign32.dll