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

Статья
03/15/2023

Функция RpcServerUseAllProtseqs сообщает библиотеке времени выполнения RPC использовать все поддерживаемые последовательности протоколов для получения удаленных вызовов процедур.

Синтаксис

RPC_STATUS RpcServerUseAllProtseqs(
  unsigned int MaxCalls,
  void         *SecurityDescriptor
);

Параметры

MaxCalls

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

SecurityDescriptor

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

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

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_NO_PROTSEQS	Нет поддерживаемых последовательностей протоколов.
RPC_S_OUT_OF_MEMORY	Недостаточно памяти.
RPC_S_INVALID_SECURITY_DESC	Недопустимый дескриптор безопасности.

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

Примечание Прослушивание всех поддерживаемых последовательностей протоколов не рекомендуется, так как это приводит к тому, что сервер будет прослушивать все последовательности протоколов, включая неупорядоченные последовательности протоколов. Рекомендуется, чтобы серверы прослушивали только основные последовательности протоколов.

Серверное приложение вызывает RpcServerUseAllProtseqs для регистрации всех поддерживаемых последовательностей протоколов в библиотеке времени выполнения RPC. Для получения удаленных вызовов процедур сервер должен зарегистрировать по крайней мере одну последовательность протоколов в библиотеке времени выполнения RPC. Список поддерживаемых последовательностей протоколов Microsoft RPC см. в справочном разделе Привязка строк.

Для каждой последовательности протокола, зарегистрированной сервером, библиотека времени выполнения RPC создает одну или несколько конечных точек, через которые сервер получает запросы на удаленные вызовы процедур. Библиотека времени выполнения RPC создает разные конечные точки для каждой последовательности протокола. Имя конечной точки создается во время выполнения RPC или операционной системой. Например, для ncacn_ip_tcp номер порта динамически определяется временем выполнения RPC в зависимости от доступности и параметров реестра.

Примечание Использование функции RpcServerUseAllProtseqs не приводит к тому, что сервер прослушивает следующие последовательности протоколов:

Примечание Для прослушивания любой из этих последовательностей протоколов каждая последовательность должна быть выбрана по отдельности.

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

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

Если компьютер настроен для использования выборочной привязки, успешное возвращение не гарантирует, что сервер создал конечные точки для всех сетевых интерфейсов, присутствующих на компьютере. Время выполнения RPC может не прослушивать некоторые сетевые интерфейсы в зависимости от параметров выборочной привязки. Кроме того, если интерфейс еще не получил IP-адрес с помощью DHCP, сервер RPC не будет прослушивать сетевой интерфейс, пока ему не будет назначен DHCP-адрес. Успешное возвращение подразумевает, что сервер прослушивает по крайней мере один сетевой интерфейс; Полный список дескрипторов привязки, по которым можно получить вызовы удаленных процедур, можно получить с помощью вызова функции RpcServerInqBindings .

Дополнительные сведения см. в разделе Привязка на стороне сервера. Для выборочной регистрации последовательностей протокола сервер вызывает RpcServerUseProtseq, RpcServerUseProtseqIf или RpcServerUseProtseqEp.

Требования


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