Fonction PvkPrivateKeyAcquireContextFromMemory
Important
Cette API est déconseillée. Microsoft peut supprimer cette API dans les versions ultérieures.
La fonction PvkPrivateKeyAcquireContextFromMemory crée un conteneur temporaire dans le fournisseur de services de chiffrement (CSP) et charge une clé privée de la mémoire dans le conteneur.
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 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
);
Paramètres
-
pwszProvName [in]
-
Pointeur vers une chaîne terminée par null qui contient le nom du fournisseur de services cloud dont le type est demandé dans dwProvType.
-
dwProvType [in]
-
Valeur DWORD pour le type CSP. Pour plus d’informations sur les types CSP, consultez Types de fournisseurs de chiffrement.
-
pbData [in]
-
Pointeur vers une mémoire tampon pour recevoir les données de contexte. L’appelant doit fournir cette ressource.
-
cbData [in]
-
Valeur DWORD qui spécifie la taille, en octets, de la mémoire tampon pbData . L’appelant doit fournir cette valeur.
-
hwndOwner [in]
-
Si un mot de passe est nécessaire pour déchiffrer les données de contexte pointées par le paramètre pbData , ce paramètre est un handle du parent de la boîte de dialogue ; sinon, elle est NULL.
-
pwszKeyName [in]
-
Pointeur vers une chaîne terminée par null qui contient le nom de la clé à récupérer.
-
pdwKeySpec [in, out, optional]
-
Pointeur vers une valeur DWORD qui spécifie le type de clé. Les valeurs possibles incluent AT_KEYEXCHANGE ou AT_SIGNATURE.
-
phCryptProv [out]
-
Pointeur vers un handle pour le fournisseur de solutions cloud.
-
ppwszTmpContainer [out]
-
Adresse d’un pointeur vers une chaîne terminée par null pour le nom de conteneur temporaire. La fonction PvkPrivateKeyAcquireContextFromMemory fournit la mémoire tampon pour cette chaîne et l’initialise. Lors de l’appel de PvkPrivateKeyAcquireContextFromMemory, l’adresse doit pointer vers une valeur NULL .
Valeur retournée
En cas de réussite, cette fonction retourne TRUE. La fonction PvkPrivateKeyAcquireContextFromMemory retourne FALSE si elle échoue.
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 |
|