структура RPC_POLICY (rpcdce.h)
Структура RPC_POLICY содержит флаги, определяющие привязку на компьютерах с несколькими адресами, и выделение портов при использовании протоколов ncacn_ip_tcp и ncadg_ip_udp .
Синтаксис
typedef struct _RPC_POLICY {
unsigned int Length;
unsigned long EndpointFlags;
unsigned long NICFlags;
} RPC_POLICY, *PRPC_POLICY;
Члены
Length
Размер структуры RPC_POLICY в байтах. Элемент Length обеспечивает совместимость с будущими версиями этой структуры, которые могут содержать дополнительные поля. Всегда устанавливайте значение Length равным sizeof(RPC_POLICY) при инициализации структуры RPC_POLICY в коде.
EndpointFlags
Набор флагов, определяющих атрибуты порта или портов, в которых сервер получает удаленные вызовы процедур. Можно указать несколько флагов (с помощью побитового оператора OR) из набора значений для заданной последовательности протокола. В следующей таблице перечислены возможные значения для элемента EndpointFlags .
| Значение | Значение |
|---|---|
|
Задает системное значение по умолчанию. |
|
Выделяет конечную точку из одного из портов, определенных в реестре как "Доступный в Интернете". Допустимо только для последовательностей протоколов ncacn_ip_tcp и ncadg_ip_udp . |
|
Выделяет конечную точку из одного из портов, определенных в реестре как "Доступные в интрасети". Допустимо только для последовательностей протоколов ncacn_ip_tcp и ncadg_ip_udp . |
|
Очередь обработки и получения сервера будет автоматически удалена при выходе сервера RPC. Все невыполненные вызовы, оставшиеся в очереди, будут потеряны. Это значение по умолчанию. Допустимо только в ncadg_mq последовательности протоколов. |
|
Указывает, что очередь получения серверного процесса сохраняется после завершения серверного процесса. По умолчанию очередь удаляется при завершении серверного процесса. Допустимо только с ncadg_mq последовательностью протоколов. |
|
Если очередь получения уже существует, так как она была открыта ранее в качестве постоянной очереди, очистите все невыполненные вызовы, ожидающие в очереди. Допустимо только для последовательности протоколов ncadg_mq. |
|
Если очередь получения уже существует, не изменяйте существующие параметры для проверки подлинности или шифрования. Допустимо только в последовательности протокола ncadg_mq. |
|
Очередь получения серверного процесса принимает только проверенные вызовы от клиентов. По умолчанию принимаются вызовы, прошедшие проверку подлинности и не прошедшие проверку подлинности. Допустимо только с ncadg_mq последовательностью протоколов. |
|
Вызовы сервера шифруются. По умолчанию принимаются как зашифрованные, так и незашифрованные вызовы. Допустимо только с ncadg_mq последовательностью протоколов. |
|
Очередь получения сервера принимает все вызовы от клиентов. Это уровень проверки подлинности по умолчанию. Допустимо только с протоколом ncadg_mq . |
|
Задает очередь получения сервера, чтобы принимать только вызовы клиентов с уровнем проверки подлинности RPC_C_AUTHN_LEVEL_PKT_INTEGRITY или RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Допустимо только в последовательности протокола ncadg_mq. |
|
Задает очередь получения сервера, чтобы принимать только вызовы клиентов с уровнем проверки подлинности RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Вызовы с более низким уровнем проверки подлинности игнорируются. Допустимо только в последовательности протокола ncadg_mq. |
NICFlags
Политика привязки к сетевым картам (NIC). В следующей таблице перечислены возможные значения для элемента NICFlags .
| Значение | Значение |
|---|---|
|
Выполняет привязку к сетевым адаптерам на основе параметров реестра. Всегда используйте это значение при использовании структуры RPC_POLICY для определения свойств очереди сообщений. |
|
Переопределяет параметры реестра и привязывается ко всем сетевым адаптерам. Если раздел Bind отсутствует в реестре, член NICFlags не будет действовать во время выполнения. Если ключ содержит недопустимое значение, вся конфигурация помечается как недопустимая и все вызовы RpcServerUseProtseq* завершатся ошибкой. |
Комментарии
Структуру RPC_Policy можно использовать для настройки политик для удаленных вызовов процедур во время выполнения. К таким политикам относятся следующие:
- Очередь сообщений. Позволяет серверу указывать свойства очереди сообщений, такие как безопасность, качество доставки и время существования очереди серверных процессов. Эта политика действует только для удаленных вызовов через транспорт очереди сообщений (ncadg_mq).
- Выделение портов для динамических портов. Указывает, должна ли конечная точка, зарегистрированная этим приложением, переходить в набор портов, доступный через Интернет или в интрасети.
- Выборочная привязка. Позволяет компьютерам с несколькими адресами выборочно привязаться к сетевым адаптерам.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | rpcdce.h (включая Rpc.h) |
См. также раздел
Настройка реестра для выделения портов и выборочной привязки
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по