Partager via


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

Voir aussi

CryptCATAdminAddCatalog

CryptCATAdminReleaseContext

CryptCATAdminRemoveCatalog