Метод ICertAdmin2::GetMyRoles (certadm.h)

Статья
08/22/2023

Метод GetMyRoles извлекает роли центра сертификации (ЦС) вызывающего объекта.

Синтаксис

HRESULT GetMyRoles(
  [in]  const BSTR strConfig,
  [out] LONG       *pRoles
);

Параметры

[in] strConfig

Строковое значение, представляющее допустимую строку конфигурации для ЦС в формате COMPUTERNAME\CANAME, где COMPUTERNAME — сетевое имя сервера служб сертификации, а CANAME — общее имя ЦС, указанное при настройке служб сертификации. Дополнительные сведения об имени строки конфигурации см. в разделе ICertConfig.

Важно!GetMyRoles не очищает внутренний кэш при изменении строки конфигурации. При изменении строки конфигурации для ЦС необходимо создать экземпляр нового объекта ICertAdmin и снова вызвать этот метод с новой строкой конфигурации.

[out] pRoles

Указатель на значение LONG , представляющее извлеченные роли ЦС для вызывающего объекта. Это может быть побитовое сочетание нуля или более следующих значений.

Значение	Значение
CA_ACCESS_ADMIN 0x1	У вызывающего абонента есть возможность администратора ЦС.
CA_ACCESS_AUDITOR 0x4	У вызывающего абонента есть возможность аудитора ЦС.
CA_ACCESS_ENROLL 0x200	Вызывающий объект имеет доступ к регистрации.
CA_ACCESS_OFFICER 0x2	У вызывающего абонента есть возможность сотрудника ЦС.
CA_ACCESS_OPERATOR 0x8	Вызывающий объект имеет возможность резервного копирования ЦС.
CA_ACCESS_READ 0x100	У вызывающего абонента есть доступ на чтение ЦС.

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

C++

Если функция выполнена успешно, возвращаемое значение будет S_OK.

Если функция завершается сбоем, возвращаемым значением является HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

VB

Возвращаемое значение — это значение Long , представляющее извлеченные роли ЦС для вызывающего объекта. Это может быть побитовое сочетание нуля или более следующих значений.

Возвращаемый код/значение	Описание
CA_ACCESS_ADMIN 0x1	У вызывающего абонента есть возможность администратора ЦС.
CA_ACCESS_AUDITOR 0x4	У вызывающего абонента есть возможность аудитора ЦС.
CA_ACCESS_ENROLL 0x200	Вызывающий объект имеет доступ к регистрации.
CA_ACCESS_OFFICER 0x2	У вызывающего абонента есть возможность сотрудника ЦС.
CA_ACCESS_OPERATOR 0x8	Вызывающий объект имеет возможность резервного копирования ЦС.
CA_ACCESS_READ 0x100	Вызывающий объект имеет доступ на чтение.

Требования


Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	certadm.h (включая Certsrv.h)
Библиотека	Certidl.lib
DLL	Certadm.dll

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

ICertAdmin2

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