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

Статья
11/20/2024

Функция RpcMgmtInqServerPrincName возвращает имя субъекта-сервера.

Синтаксис

RPC_STATUS RpcMgmtInqServerPrincNameA(
  RPC_BINDING_HANDLE Binding,
  unsigned long      AuthnSvc,
  RPC_CSTR           *ServerPrincName
);

Параметры

Binding

Чтобы получить имя субъекта для сервера, укажите дескриптор привязки сервера для этого сервера. Чтобы получить имя субъекта для собственного (локального) приложения, укажите значение NULL.

AuthnSvc

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

ServerPrincName

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

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

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

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

Замечания

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

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

Сервер должен прослушивать удаленные вызовы процедур для успешной работы этой функции. Если сервер не прослушивает, функция завершается ошибкой.

Заметка

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

Требования

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

См. также

RpcStringFree

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