Поделиться через


Функция CryptCATAdminAcquireContext (mscat.h)

[Функция CryptCATAdminAcquireContext доступна для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Функция CryptCATAdminAcquireContext получает дескриптор контекста администратора каталога. Этот дескриптор можно использовать при последующих вызовах функций CryptCATAdminAddCatalog, CryptCATAdminEnumCatalogFromHash и CryptCATAdminRemoveCatalog . У этой функции нет связанной библиотеки импорта. Для динамического связывания с Wintrust.dll необходимо использовать функции LoadLibrary и GetProcAddress .

Синтаксис

BOOL CryptCATAdminAcquireContext(
  [out] HCATADMIN  *phCatAdmin,
  [in]  const GUID *pgSubsystem,
  [in]  DWORD      dwFlags
);

Параметры

[out] phCatAdmin

Указатель на дескриптор контекста администратора каталога, назначенный этой функцией. Завершив использование дескриптора, закройте его, вызвав функцию CryptCATAdminReleaseContext .

[in] pgSubsystem

Указатель на GUID, идентифицирующий подсистему. DRIVER_ACTION_VERIFY представляет подсистему для компонентов операционной системы и сторонних драйверов. Это подсистема, используемая в большинстве реализаций.

[in] dwFlags

Не используется; Значение равно нулю.

Возвращаемое значение

Возвращаемое значение равно TRUE , если функция выполнена успешно; False , если функция завершается сбоем.

Для получения дополнительных сведений об ошибке вызовите функцию GetLastError . Полный список кодов ошибок, предоставляемых операционной системой, см. в разделе Системные коды ошибок.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header mscat.h
Библиотека Wintrust.lib
DLL Wintrust.dll

См. также раздел

CryptCATAdminAddCatalog

CryptCATAdminReleaseContext

CryptCATAdminRemoveCatalog