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

Статья
08/25/2023

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

Синтаксис

RPC_STATUS RpcMgmtInqServerPrincName(
  RPC_BINDING_HANDLE Binding,
  unsigned long      AuthnSvc,
  RPC_WSTR           *ServerPrincName
);

Параметры

Binding

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

AuthnSvc

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

ServerPrincName

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

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

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

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

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

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

Требования

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

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

RpcStringFree

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