Fonction CryptCATAdminAcquireContext (mscat.h)
[La fonction CryptCATAdminAcquireContext est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]
La fonction CryptCATAdminAcquireContext acquiert un handle dans un contexte d’administrateur de catalogue. Ce handle peut être utilisé par les appels suivants aux fonctions CryptCATAdminAddCatalog, CryptCATAdminEnumCatalogFromHash et CryptCATAdminRemoveCatalog . 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 CryptCATAdminAcquireContext(
[out] HCATADMIN *phCatAdmin,
[in] const GUID *pgSubsystem,
[in] 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] 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] dwFlags
Non utilisé ; défini sur zéro.
Valeur retournée
La valeur de retour est TRUE si la fonction réussit ; FALSE si la fonction échoue.
Pour obtenir des informations d’erreur étendues, appelez la fonction GetLastError . Pour obtenir la liste complète des codes d’erreur fournis par le système d’exploitation, consultez Codes d’erreur système.
Configuration requise
| 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] |
| Plateforme cible | Windows |
| En-tête | mscat.h |
| Bibliothèque | Wintrust.lib |
| DLL | Wintrust.dll |