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

Статья
08/25/2023

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

Синтаксис

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

Параметры

AuthnSvc

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

PrincName

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

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

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_OUT_OF_MEMORY	Недостаточно памяти для завершения операции.

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

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

Примечание

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

Требования


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

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

RpcBindingSetAuthInfo

RpcServerRegisterAuthInfo

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