Функция RpcBindingInqAuthClientA (rpcdce.h)
Серверное приложение вызывает функцию RpcBindingInqAuthClient , чтобы получить имя участника или атрибуты привилегий клиента, прошедшего проверку подлинности, который выполнил удаленный вызов процедуры.
Синтаксис
RPC_STATUS RpcBindingInqAuthClientA(
RPC_BINDING_HANDLE ClientBinding,
RPC_AUTHZ_HANDLE *Privs,
RPC_CSTR *ServerPrincName,
unsigned long *AuthnLevel,
unsigned long *AuthnSvc,
unsigned long *AuthzSvc
);
Параметры
ClientBinding
Дескриптор привязки клиента, который сделал удаленный вызов процедуры. Это значение может быть равно 0. См. заметки.
Privs
Возвращает указатель на дескриптор привилегированных сведений для клиентского приложения, которое выполнило удаленный вызов процедуры для дескриптора привязки ClientBinding . Для вызовов ncalrpcPrivs содержит строку с именем участника клиента.
Данные, на которые ссылается этот параметр, доступны только для чтения и не должны изменяться серверным приложением. Если сервер хочет сохранить какие-либо из возвращенных данных, сервер должен скопировать данные в память, выделенную сервером.
Данные, на которые указывает параметр Privs , поступают непосредственно из поставщика общих служб. Таким образом, формат данных зависит от поставщика общих служб. Дополнительные сведения о поставщиках поддержки безопасности см. в разделе Поставщики поддержки безопасности (SSP).
ServerPrincName
Возвращает указатель на указатель на имя субъекта-сервера, указанное серверным приложением, которое вызывало функцию RpcServerRegisterAuthInfo . Содержимое возвращаемого имени и его синтаксис определяются используемой службой проверки подлинности. Для SCHANNEL SSP имя субъекта имеет формат microsoft-standard (msstd). Дополнительные сведения о формате msstd см. в разделе Имена субъектов.
Укажите значение NULL, чтобы запретить RpcBindingInqAuthClient возвращать параметр ServerPrincName . В этом случае приложение не вызывает функцию RpcStringFree .
AuthnLevel
Возвращает указатель, заданный на уровень проверки подлинности, запрошенный клиентским приложением, которое выполнило удаленный вызов процедуры для дескриптора привязки ClientBinding .
Укажите значение NULL, чтобы запретить RpcBindingInqAuthClient возвращать параметр AuthnLevel .
AuthnSvc
Возвращает указатель, заданный на службу проверки подлинности, запрошенную клиентским приложением, которое выполнило удаленный вызов процедуры для дескриптора привязки ClientBinding . Список уровней проверки подлинности, поддерживаемых RPC, см. в разделе Константы уровня проверки подлинности.
Укажите значение NULL, чтобы запретить RpcBindingInqAuthClient возвращать параметр AuthnSvc .
AuthzSvc
Возвращает указатель, заданный на службу авторизации, запрошенную клиентским приложением, которое выполнило удаленный вызов процедуры для дескриптора привязки ClientBinding .
Укажите значение NULL, чтобы запретить RpcBindingInqAuthClient возвращать параметр AuthzSvc . Этот параметр не используется службой проверки подлинности RPC_C_AUTHN_WINNT. Возвращаемое значение всегда будет RPC_C_AUTHZ_NONE.
Возвращаемое значение
Значение | Значение |
---|---|
|
Вызов выполнен успешно. |
|
Недопустимый дескриптор привязки. |
|
Это был неправильный тип привязки для операции. |
|
Привязка не содержит сведений о проверке подлинности. |
Комментарии
Серверное приложение вызывает функцию RpcBindingInqAuthClient , чтобы получить имя участника или атрибуты привилегий клиента, прошедшего проверку подлинности, который выполнил удаленный вызов процедуры. Кроме того, RpcBindingInqAuthClient возвращает службу проверки подлинности, уровень проверки подлинности и имя субъекта-сервера, указанные клиентом. Сервер может использовать возвращенные данные для авторизации.
Библиотека времени выполнения RPC выделяет память для возвращаемого параметра ServerPrincName . Приложение отвечает за вызов функции RpcStringFree для возвращаемой строки аргумента.
Для синхронных вызовов RPC серверное приложение может использовать ноль в качестве значения параметра ClientBinding . При использовании нуля извлекаются сведения о проверке подлинности и авторизации из выполняемого в данный момент удаленного вызова процедуры.
Примечание
Заголовок rpcdce.h определяет RpcBindingInqAuthClient в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | rpcdce.h (включая Rpc.h) |
Библиотека | Rpcrt4.lib |
DLL | Rpcrt4.dll |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по