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

Статья
11/20/2024

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

Синтаксис

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

Члены

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 значение будет учитываться.

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

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

Заметка

Заголовок rpcdce.h определяет RPC_ENDPOINT_TEMPLATE как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8 [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2012 [только классические приложения]
заголовка	rpcdce.h (include Rpc.h)

См. также

RpcServerInqBindings

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