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

Статья
03/01/2024

Функция RpcMgmtSetAuthorizationFn устанавливает функцию авторизации для обработки удаленных вызовов функций управления сервера.

Синтаксис

RPC_STATUS RpcMgmtSetAuthorizationFn(
  RPC_MGMT_AUTHORIZATION_FN AuthorizationFn
);

Параметры

AuthorizationFn

Указывает функцию авторизации. Библиотека времени выполнения сервера RPC автоматически вызывает эту функцию всякий раз, когда время выполнения сервера получает клиентский запрос на выполнение одной из функций удаленного управления. Сервер должен реализовать эту функцию. Приложения указывают значение NULL , чтобы отменить регистрацию ранее зарегистрированной функции авторизации. После такого вызова используются авторизации по умолчанию.

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

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.

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

Серверные приложения вызывают функцию RpcMgmtSetAuthorizationFn , чтобы установить функцию авторизации, которая управляет доступом к функциям удаленного управления сервера. Если сервер не вызывает RpcMgmtSetAuthorizationFn или вызывает со значением NULL для AuthorizationFn, библиотека времени выполнения сервера использует следующие авторизации по умолчанию.

Удаленная функция	Авторизация по умолчанию
RpcMgmtInqIfIds	Активировано
RpcMgmtInqServerPrincName	Активировано
RpcMgmtInqStats	Активировано
RpcMgmtIsServerListening	Активировано
RpcMgmtStopServerListening	Выключено

В предыдущей таблице значение "Включено" означает, что удаленные функции могут выполняться всеми клиентами, а значение "Отключено" означает, что все клиенты не могут выполнять удаленную функцию.

Требования

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