Функция RpcBindingInqAuthInfoA (rpcdce.h)
Функция 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 .
Возвращаемое значение
Значение | Значение |
---|---|
|
Вызов выполнен успешно. |
|
Недопустимый дескриптор привязки. |
|
Это была неправильная привязка для операции. |
|
Привязка не содержит сведений о проверке подлинности. |
Комментарии
Клиентское приложение вызывает функцию RpcBindingInqAuthInfo для просмотра сведений о проверке подлинности и авторизации, связанных с дескриптором привязки сервера. Аналогичная функция RpcBindingInqAuthInfoEx дополнительно предоставляет сведения о качестве обслуживания безопасности для дескриптора привязки.
Библиотека времени выполнения RPC выделяет память для возвращаемого параметра ServerPrincName . Приложение отвечает за вызов функции RpcStringFree для возвращаемой строки аргумента.
Примечание
Заголовок rpcdce.h определяет RpcBindingInqAuthInfo в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Профессиональная [классические приложения | Приложения UWP] |
Минимальная версия сервера | Windows 2000 Server [классические приложения | Приложения UWP] |
Целевая платформа | Windows |
Header | rpcdce.h (включая Rpc.h) |
Библиотека | Rpcrt4.lib |
DLL | Rpcrt4.dll |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по