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