Функция AuthzModifyClaims (authz.h)

Функция AuthzModifyClaims добавляет, удаляет или изменяет утверждения пользователей и устройств в контексте клиента Authz.

Синтаксис

AUTHZAPI BOOL AuthzModifyClaims(
  [in]           AUTHZ_CLIENT_CONTEXT_HANDLE            hAuthzClientContext,
  [in]           AUTHZ_CONTEXT_INFORMATION_CLASS        ClaimClass,
  [in]           PAUTHZ_SECURITY_ATTRIBUTE_OPERATION    pClaimOperations,
  [in, optional] PAUTHZ_SECURITY_ATTRIBUTES_INFORMATION pClaims
);

Параметры

[in] hAuthzClientContext

Дескриптор для изменяемого контекста клиента.

[in] ClaimClass

Тип информации, которую необходимо изменить. Вызывающий объект может указать AuthzContextInfoUserClaims или AuthzContextInfoDeviceClaims.

[in] pClaimOperations

Указатель на массив AUTHZ_SECURITY_ATTRIBUTE_OPERATION значений перечисления, определяющих тип изменения утверждения.

[in, optional] pClaims

Указатель на структуру AUTHZ_SECURITY_ATTRIBUTES_INFORMATION , указывающую изменяемые утверждения.

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

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

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

Комментарии

Перечисление AUTHZ_SECURITY_ATTRIBUTE_OPERATION должно иметь только один элемент, если значение этого элемента AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE_ALL. В противном случае массив имеет то же количество элементов, что и соответствующий PAUTHZ_SECURITY_ATTRIBUTES_INFORMATION.

Если перечисление AUTHZ_SECURITY_ATTRIBUTE_OPERATION AUTHZ_SECURITY_ATTRIBUTE_OPERATION_REPLACE и функция завершается сбоем, вызовите Метод GetLastError. Если код ошибки ERROR_ALREADY_EXISTS, значения утверждения имеют повторяющиеся записи.

Требования