Функция RpcBindingInqAuthInfoA (rpcdce.h)

Статья
11/20/2024

Функция RpcBindingInqAuthInfo возвращает сведения о проверке подлинности и авторизации из дескриптора привязки.

Синтаксис

RPC_STATUS RpcBindingInqAuthInfoA(
  RPC_BINDING_HANDLE       Binding,
  RPC_CSTR                 *ServerPrincName,
  unsigned long            *AuthnLevel,
  unsigned long            *AuthnSvc,
  RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
  unsigned long            *AuthzSvc
);

Параметры

Binding

Дескриптор привязки сервера, из которого возвращаются сведения о проверке подлинности и авторизации.

ServerPrincName

Возвращает указатель на указатель на ожидаемое имя субъекта сервера, на который ссылается Привязка. Содержимое возвращаемого имени и его синтаксиса определяются службой проверки подлинности, используемой службой проверки подлинности.

Укажите значение NULL, чтобы предотвратить RpcBindingInqAuthInfo возвращать параметр ServerPrincName. В этом случае приложение не вызывает функцию RpcStringFree.

AuthnLevel

Возвращает указатель на уровень проверки подлинности, используемый для удаленных вызовов процедур, выполненных с помощью привязки. См. примечание.

Укажите значение NULL, чтобы запретить функцию возвращать параметр AuthnLevel.

Уровень, возвращаемый в параметре AuthnLevel, может отличаться от уровня, указанного при вызове клиентом функции RpcBindingSetAuthInfo. Это несоответствие возникает, когда библиотека времени выполнения RPC не поддерживает уровень проверки подлинности, указанный клиентом, и автоматически обновляется до следующего более высокого уровня проверки подлинности.

AuthnSvc

Возвращает указатель на службу проверки подлинности, указанную для удаленных вызовов процедур, выполненных с помощью привязки. См. примечание.

Укажите значение NULL, чтобы предотвратить RpcBindingInqAuthInfo возвращать параметр AuthnSvc.

AuthIdentity

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

Укажите значение NULL, чтобы предотвратить RpcBindingInqAuthInfo возвращать параметр AuthIdentity.

AuthzSvc

Возвращает указатель на службу авторизации, запрошенную клиентским приложением, которое вызывало удаленный вызов процедуры для привязки привязки см. примечание.

Укажите значение NULL, чтобы предотвратить RpcBindingInqAuthInfo возвращать параметр AuthzSvc.

Примечание Список служб проверки подлинности, поддерживаемых RPC, см. Authentication-Service констант.

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

Ценность	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_INVALID_BINDING	Дескриптор привязки недопустим.
RPC_S_WRONG_KIND_OF_BINDING	Это был неправильный вид привязки для операции.
RPC_BINDING_HAS_NO_AUTH	Привязка не содержит сведений о проверке подлинности.

Примечание Список допустимых кодов ошибок см. в разделе возвращаемых значений RPC.

Замечания

Клиентское приложение вызывает функцию RpcBindingInqAuthInfo для просмотра сведений о проверке подлинности и авторизации, связанных с дескриптором привязки сервера. Аналогичная функция RpcBindingInqAuthInfoEx дополнительно предоставляет сведения о качестве обслуживания безопасности для дескриптора привязки.

Библиотека времени выполнения RPC выделяет память для возвращаемого параметра ServerPrincName. Приложение отвечает за вызов функции RpcStringFree для этой возвращаемой строки аргумента.

Заметка

Заголовок rpcdce.h определяет RpcBindingInqAuthInfo как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [классические приложения \| Приложения UWP]
минимальный поддерживаемый сервер	Windows 2000 Server [классические приложения \| Приложения UWP]
целевая платформа	Виндоус
заголовка	rpcdce.h (include Rpc.h)
библиотеки	Rpcrt4.lib
DLL	Rpcrt4.dll

См. также

RpcBindingInqAuthClient

RpcBindingInqAuthInfoEx

RpcBindingInqOption

RpcBindingSetAuthInfo

RpcStringFree

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