Функция RpcMgmtInqServerPrincNameW (rpcdce.h)
Функция RpcMgmtInqServerPrincName возвращает имя участника сервера.
Синтаксис
RPC_STATUS RpcMgmtInqServerPrincNameW(
RPC_BINDING_HANDLE Binding,
unsigned long AuthnSvc,
RPC_WSTR *ServerPrincName
);
Параметры
Binding
Чтобы получить имя участника для сервера, укажите дескриптор привязки сервера для этого сервера. Чтобы получить имя участника для собственного (локального) приложения, укажите значение NULL.
AuthnSvc
Служба проверки подлинности, для которой возвращается имя участника. Допустимые значения — это константы для любого допустимого поставщика безопасности.
ServerPrincName
Возвращает имя участника, зарегистрированное для службы проверки подлинности в AuthnSvc сервером, на который ссылается привязка. Если зарегистрировано несколько имен, возвращается только одно имя.
Возвращаемое значение
Значение | Значение |
---|---|
|
Вызов выполнен успешно. |
|
Недопустимый дескриптор привязки. |
|
Это была неправильная привязка для операции. |
Комментарии
Приложение вызывает функцию RpcMgmtInqServerPrincName , чтобы получить имя участника сервера, зарегистрированного для указанной службы проверки подлинности.
Библиотека времени выполнения RPC выделяет память для строки, возвращаемой в ServerPrincName. Приложение отвечает за вызов функции RpcStringFree для освобождения памяти, используемой этой функцией.
Для успешного выполнения этой функции сервер должен прослушивать удаленные вызовы процедур. Если сервер не прослушивает, функция завершается сбоем.
Примечание
Заголовок rpcdce.h определяет RpcMgmtInqServerPrincName в качестве псевдонима, который автоматически выбирает версию 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 как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по