функция обратного вызова RPC_MGMT_AUTHORIZATION_FN (rpcdce.h)

Статья
08/25/2023

RPC_MGMT_AUTHORIZATION_FN позволяет серверным программам реализовывать пользовательские методы авторизации RPC.

Синтаксис

RPC_MGMT_AUTHORIZATION_FN RpcMgmtAuthorizationFn;

int RpcMgmtAuthorizationFn(
  RPC_BINDING_HANDLE ClientBinding,
  unsigned long RequestedMgmtOperation,
  RPC_STATUS *Status
)
{...}

Параметры

ClientBinding

Дескриптор привязки клиента или сервера.

RequestedMgmtOperation

Значение RequestedMgmtOperation зависит от запрошенной удаленной функции, как показано в следующей таблице.

Вызываемая удаленная функция	Значение
RpcMgmtInqIfIds	RPC_C_MGMT_INQ_IF_IDS
RpcMgmtInqServerPrincName	RPC_C_MGMT_INQ_PRINC_NAME
RpcMgmtInqStats	RPC_C_MGMT_INQ_STATS
RpcMgmtIsServerListening	RPC_C_MGMT_IS_SERVER_LISTEN
RpcMgmtStopServerListening	RPC_C_MGMT_STOP_SERVER_LISTEN

Функция авторизации должна обрабатывать все эти значения.

Status

Если значение Status равно 0 (ноль) или RPC_S_OK, функция удаленного управления возвращает клиенту значение status RPC_S_ACCESS_DENIED. Если функция авторизации возвращает любое другое значение для параметра Состояние, это значение Состояния возвращается клиенту функцией удаленного управления.

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

Возвращает значение TRUE , если вызывающему клиенту разрешен доступ к запрошенной функции управления. Если функция авторизации возвращает значение FALSE, функция управления не может выполниться. В этом случае функция возвращает клиенту значение Состояния :

Когда клиент запрашивает одну из функций удаленного управления сервера, библиотека времени выполнения сервера вызывает функцию авторизации с помощью ClientBinding и RequestedMgmtOperation. Функция авторизации использует эти параметры, чтобы определить, может ли вызывающий клиент выполнить запрошенную функцию управления.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	rpcdce.h

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

Функции авторизации

RpcMgmtSetAuthorizationFn

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