Fonction PvkPrivateKeyAcquireContextFromMemory

Article
06/13/2023

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	Mssign32.dll

Partager via