Функция 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