Fonction PvkGetCryptProv

Important

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

 

La fonction PvkGetCryptProv obtient un handle à un fournisseur de services de chiffrement (CSP) en fonction d’un fichier de clé privée ou d’un nom de conteneur de clé.

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 établir une liaison dynamique vers Mssign32.dll.

 

Syntaxe

HRESULT WINAPI PvkGetCryptProv(
  _In_      HWND       hwnd,
  _In_      LPCWSTR    pwszCaption,
  _In_      LPCWSTR    pwszCapiProvider,
  _In_      DWORD      dwProviderType,
  _In_      LPCWSTR    pwszPvkFile,
  _In_      LPCWSTR    pwszKeyContainerName,
  _Out_     DWORD      *pdwKeySpec,
  _Out_opt_ LPWSTR     *ppwszTmpContainer,
  _Out_     HCRYPTPROV *phCryptProv
);

Paramètres

hwnd [in]

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

pwszCaption [in]

Pointeur vers une chaîne terminée par null pour la boîte de dialogue légende.

pwszCapiProvider [in]

Pointeur vers une chaîne terminée par null pour le nom csp.

dwProviderType [in]

Valeur DWORD qui représente le type de fournisseur de chiffrement. Pour plus d’informations, consultez Types de fournisseurs de chiffrement.

pwszPvkFile [in]

Pointeur vers une chaîne terminée par null qui contient le nom d’un fichier de clé privée.

pwszKeyContainerName [in]

Pointeur vers une chaîne terminée par null pour le nom du conteneur de clé privée.

pdwKeySpec [out]

Pointeur vers une valeur DWORD pour le type de clé du conteneur retourné avec phCryptProv et ppwszTmpContainer.

ppwszTmpContainer [out, facultatif]

Adresse d’un pointeur vers une chaîne terminée par null pour le nom du conteneur de clé temporaire. La fonction PvkGetCryptProv fournit et initialise le conteneur temporaire. Lors de l’appel de PvkGetCryptProv, l’adresse doit pointer vers une valeur NULL .

phCryptProv [out]

Pointeur vers un handle pour le fournisseur de solutions Cloud.

Valeur retournée

Si la méthode réussit, elle retourne S_OK.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Notes

La fonction PvkGetCryptProv tente d’abord d’obtenir le handle du fournisseur à partir du nom de conteneur de clé spécifié par le paramètre pwszKeyContainerName . Si vous transmettez null pour le paramètre pwszKeyContainerName , PvkGetCryptProv tente d’obtenir le fournisseur à partir du fichier de clé privée spécifié dans le paramètre pwszPvkFile .

Une fois que vous avez terminé d’utiliser le fournisseur csp, libérez le handle du fournisseur et le conteneur de clés temporaires en appelant la fonction PvkFreeCryptProv .

Spécifications

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