Функция RpcServerUseProtseqExA (rpcdce.h)
Функция RpcServerUseProtseqEx сообщает библиотеке времени выполнения RPC использовать указанную последовательность протоколов для получения удаленных вызовов процедур.
Синтаксис
RPC_STATUS RpcServerUseProtseqExA(
RPC_CSTR Protseq,
unsigned int MaxCalls,
void *SecurityDescriptor,
PRPC_POLICY Policy
);
Параметры
Protseq
Указатель на строковый идентификатор последовательности протокола для регистрации в библиотеке времени выполнения RPC.
MaxCalls
Длина очереди невыполненной работы для последовательности протоколов ncacn_ip_tcp. Все остальные последовательности протоколов игнорируют этот параметр. Используйте RPC_C_PROTSEQ_MAX_REQS_DEFAULT, чтобы указать значение по умолчанию. См. примечания.
SecurityDescriptor
Указатель на необязательный параметр, предоставленный для подсистемы безопасности Windows XP/2000/NT. Используется только для ncacn_np и последовательностей протоколов ncalrpc. Все остальные последовательности протоколов игнорируют этот параметр. Использование дескриптора безопасности в конечной точке для обеспечения безопасности сервера не рекомендуется. Этот параметр не отображается в спецификации DCE для этого API.
Policy
Указатель на структуру RPC_POLICY, которая содержит флаги, ограничивающие выделение портов для динамических портов и разрешающие многодомные компьютеры выборочно привязаться к сетевым картам. Структура RPC_POLICY позволяет вызывающему объекту направлять библиотеку времени выполнения RPC для использования порта интрасети или порта Интернета, а также других параметров.
Возвращаемое значение
| Ценность | Значение |
|---|---|
|
Вызов выполнен успешно. |
|
Последовательность протоколов не поддерживается на этом узле. |
|
Последовательность протоколов. |
|
Система не хватает памяти. |
|
Дескриптор безопасности недопустим. |
Замечания
Параметры и эффекты RpcServerUseProtseqEx вложены в RpcServerUseProtseq. Разница заключается в поле политики
Задание поля NICFlags структуры RPC_POLICY равно нулю делает эту расширенную функцию функционально эквивалентной исходной RpcServerUseProtseq, а сервер привязывается к сетевым адаптерам на основе параметров в системном реестре. Дополнительные сведения см. в настройке реестра для выделения портов и выборочной привязки.
Для каждой последовательности протоколов, зарегистрированной сервером, библиотека времени выполнения RPC создает одну или несколько конечных точек, с помощью которых сервер получает запросы на вызовы удаленных процедур. Библиотека времени выполнения RPC создает разные конечные точки для каждой последовательности протоколов. Имя конечной точки создается временем выполнения RPC или операционной системой. Например, для ncacn_ip_tcpномер порта динамически определяется временем выполнения RPC в зависимости от параметров доступности и реестра.
Для 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.
Чтобы зарегистрировать все последовательности протоколов, сервер вызывает подпрограмму RpcServerUseAllProtseqsEx.
Дополнительные сведения см. в разделе Server-Side Привязка.
Заметка
Заголовок rpcdce.h определяет RpcServerUseProtseqEx как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | rpcdce.h (include Rpc.h) |
| библиотеки |
Rpcrt4.lib |
| DLL | Rpcrt4.dll |