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

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

  • Статья

Функция RpcServerInqDefaultPrincName получает имя участника по умолчанию для данной службы проверки подлинности.

Синтаксис

RPC_STATUS RpcServerInqDefaultPrincNameA(
  unsigned long AuthnSvc,
  RPC_CSTR      *PrincName
);

Параметры

AuthnSvc

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

PrincName

При успешном выполнении содержит имя участника по умолчанию для заданной службы проверки подлинности, указанное в параметре AuthnSvc . Используемая служба проверки подлинности определяет содержимое имени и его синтаксис. Это имя участника должно использоваться в качестве параметра ServerPrincName функции RpcServerRegisterAuthInfo . Если функция выполнена успешно, необходимо освободить PrincName с помощью функции RpcStringFree . Если функция завершается сбоем, содержимое PrincName не определено и вызывающий объект не обязан освобождать его.

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

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

Комментарии

Эта функция является рекомендуемым способом получения имени субъекта-сервера, передаваемого в функцию RpcServerRegisterAuthInfo . Хотя создание имени субъекта-сервера возможно без использования этой функции, вызов функции проще и удобнее в разных версиях операционной системы.

Примечание

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

Требования

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

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

RpcBindingSetAuthInfo

RpcServerRegisterAuthInfo