Функция LsaGetAppliedCAPIDs (ntlsa.h)

Функция LsaGetAppliedCAPIDs возвращает массив идентификаторов (CAPID) центральных политик доступа (CAPID) всех ЦС, примененных к определенному компьютеру.

Синтаксис

NTSTATUS LsaGetAppliedCAPIDs(
  [in, optional] PLSA_UNICODE_STRING SystemName,
  [out]          PSID                **CAPIDs,
  [out]          PULONG              CAPIDCount
);

Параметры

[in, optional] SystemName

Указатель на структуру LSA_UNICODE_STRING , содержащую имя конкретного компьютера. Имя может иметь вид "ComputerName" или "\ComputerName". Если этот параметр имеет значение NULL, функция возвращает идентификаторы CAPID локального компьютера.

[out] CAPIDs

Указатель на переменную, получающую массив указателей на идентификаторы CAPID, которые определяют ЦС, доступные на указанном компьютере. Завершив использование CAPID, вызовите функцию LsaFreeMemory для каждого элемента в массиве и всего массива.

[out] CAPIDCount

Указатель на переменную, которая получает количество CSP, доступных на указанном компьютере. Массив, возвращаемый в параметре CAPIDs , содержит то же количество элементов, что и параметр CAPIDCount .

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

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

Если функция завершается сбоем, возвращаемое значение является одним из возвращаемых значений функции политики LSA. Для преобразования кода NTSTATUS в код ошибки Windows можно использовать функцию LsaNtStatusToWinError.

Комментарии

Для получения конкретных сведений о централизованных политиках доступа можно запросить атрибуты объекта центральной политики доступа в Active Directory на контроллере домена указанного компьютера. Найдите объект, атрибут msAuthz-CentralAccessPolicyID которого соответствует одному из возвращенных CAPID.

Требования

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

Централизованная политика авторизации