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

Статья
11/20/2024

Функция 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	rpcdce.h (include Rpc.h)
библиотеки	Rpcrt4.lib
DLL	Rpcrt4.dll

См. также

RpcBindingSetAuthInfo

RpcServerRegisterAuthInfo

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