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

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

  • Статья

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

Синтаксис

RPC_STATUS RpcServerInqDefaultPrincName(
  unsigned long AuthnSvc,
  RPC_WSTR      *PrincName
);

Параметры

AuthnSvc

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

PrincName

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

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

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

Комментарии

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

Требования

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

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

RpcBindingSetAuthInfo

RpcServerRegisterAuthInfo