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

структура RPC_ENDPOINT_TEMPLATE (rpcdce.h)

  • Статья

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

Синтаксис

typedef struct {
  unsigned long Version;
  RPC_CSTR      ProtSeq;
  RPC_CSTR      Endpoint;
  void          *SecurityDescriptor;
  unsigned long Backlog;
} RPC_ENDPOINT_TEMPLATE, *PRPC_ENDPOINT_TEMPLATE;

Члены

Version

Это поле зарезервировано и должно иметь значение 0.

ProtSeq

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

Endpoint

Необязательный указатель на сведения об адресе конечной точки для использования при создании привязки для последовательности протоколов, указанной в параметре Protseq . Укажите значение NULL для использования динамических конечных точек.

SecurityDescriptor

Указатель на необязательный параметр, предоставленный для подсистемы безопасности. Используется только для последовательностей протоколов ncacn_np и ncalrpc. Все остальные последовательности протоколов игнорируют этот параметр. Не рекомендуется использовать дескриптор безопасности в конечной точке, чтобы обеспечить безопасность сервера.

Backlog

Длина очереди невыполненной работы для последовательности протоколов ncacn_ip_tcp. Все остальные последовательности протоколов игнорируют этот параметр. Используйте RPC_C_PROTSEQ_MAX_REQS_DEFAULT , чтобы указать значение по умолчанию. Дополнительные сведения см. в разделе "Примечания".

Комментарии

Значение, предоставленное в разделе Невыполненная работа приложениями, является лишь подсказкой. Время выполнения RPC или поставщик сокетов Windows может переопределить значение. Например, в Windows XP или Windows 2000 Профессиональная значение ограничено 5. Значения больше 5 игнорируются, а вместо них используется 5. В Windows Server 2003 и Windows 2000 Server это значение будет учитываться.

Приложения должны быть осторожны, чтобы передать разумные значения в невыполненной работы. Большие значения на сервере, расширенном сервере или сервере datacenter могут привести к использованию большого объема памяти нестраничного пула. Использование слишком малого значения также является неблагоприятным, так как это может привести к тому, что пакеты TCP SYN будут удовлетворены TCP RST с сервера, если очередь невыполненной работы будет исчерпана.

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

Требования

Требование Значение
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Верхняя часть rpcdce.h (включая Rpc.h)

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

RpcServerInqBindings