Fonction CryptCATAdminAcquireContext2 (mscat.h)
La fonction CryptCATAdminAcquireContext2 acquiert un handle dans un contexte d’administrateur de catalogue pour un algorithme de hachage et une stratégie de hachage donnés.
Vous pouvez utiliser ce handle dans les appels suivants aux fonctions suivantes :
Cette fonction n’a pas de bibliothèque d’importation associée. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour établir un lien dynamique vers Wintrust.dll.Syntaxe
BOOL CryptCATAdminAcquireContext2(
[out] HCATADMIN *phCatAdmin,
[in, optional] const GUID *pgSubsystem,
[in, optional] PCWSTR pwszHashAlgorithm,
[in, optional] PCCERT_STRONG_SIGN_PARA pStrongHashPolicy,
DWORD dwFlags
);
Paramètres
[out] phCatAdmin
Pointeur vers le handle de contexte de l’administrateur du catalogue affecté par cette fonction. Une fois que vous avez terminé d’utiliser le handle, fermez-le en appelant la fonction CryptCATAdminReleaseContext .
[in, optional] pgSubsystem
Pointeur vers le GUID qui identifie le sous-système. DRIVER_ACTION_VERIFY représente le sous-système pour les composants du système d’exploitation et les pilotes tiers. Il s’agit du sous-système utilisé par la plupart des implémentations.
[in, optional] pwszHashAlgorithm
Chaîne Unicode terminée par null facultative qui spécifie le nom de l’algorithme de hachage à utiliser lors du calcul et de la vérification des hachages. Cette valeur peut être NULL. S’il est NULL, l’algorithme de hachage par défaut peut être choisi, en fonction de la valeur que vous avez définie pour le paramètre pStrongHashPolicy . L’algorithme par défaut dans Windows 8 est SHA1. La valeur par défaut peut changer dans les versions ultérieures de Windows. Pour plus d'informations, consultez la section Notes.
[in, optional] pStrongHashPolicy
Pointeur vers une structure de CERT_STRONG_SIGN_PARA qui contient les paramètres utilisés pour case activée pour les signatures fortes. La fonction choisit l’algorithme de hachage commun le plus bas qui satisfait à la stratégie spécifiée et à l’algorithme spécifié par le paramètre pwszHashAlgorithm ou l’algorithme système par défaut (si aucun algorithme n’est spécifié).
dwFlags
Réservé. Cette valeur doit être zéro.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro (TRUE).
Si la fonction échoue, la valeur de retour est zéro (FALSE). Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Le tableau suivant répertorie les codes d’erreur les plus couramment retournés par la fonction GetLastError .
| Code de retour | Description |
|---|---|
|
Le paramètre phCatAdmin ne peut pas être NULL.
Le paramètre dwFlags doit être égal à zéro (0). |
|
La mémoire était insuffisante pour créer un objet administrateur de catalogue. |
|
L’algorithme de hachage spécifié par le paramètre pwszHashAlgorithm est introuvable. |
Notes
Cette fonction vous permet de choisir, ou choisir pour vous, l’algorithme de hachage à utiliser dans les fonctions qui nécessitent le contexte administrateur du catalogue. Bien que vous puissiez définir le nom de l’algorithme de hachage, nous vous recommandons de laisser la fonction déterminer l’algorithme. Cela protège votre application contre les algorithmes de codage dur qui peuvent devenir non approuvés à l’avenir.
Spécifications
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | mscat.h |
| Bibliothèque | Wintrust.lib |
| DLL | Wintrust.dll |