Функция 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 |