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

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

  • Статья

Функция 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header rpcdce.h (включая Rpc.h)
Библиотека Rpcrt4.lib
DLL Rpcrt4.dll

См. также раздел

RpcStringFree