Атрибут конечной точки

  • Статья

Атрибут [endpoint] указывает известный порт или порты (конечные точки связи), на которых серверы интерфейса прослушивают вызовы.

endpoint("protocol-sequence:[endpoint-port]" [ , ...] )

Параметры

последовательность протоколов

Задает символьную строку, представляющую допустимое сочетание протокола RPC (например, "ncacn"), транспортного протокола (например, "tcp") и сетевого протокола (например, "ip"). Список допустимых последовательностей протокола см. в разделе Константы последовательности протоколов.

порт конечной точки

Задает строку, представляющую обозначение конечной точки для указанного семейства протоколов. Синтаксис строки порта зависит от каждой последовательности протокола.

Комментарии

Атрибут [endpoint] указывает семейство транспортных ресурсов, например протокол, ориентированный на подключение TCP/IP, протокол NetBIOS или протокол, ориентированный на подключение по именованной канале. Использование атрибута [endpoint] согласуется с другими методами добавления конечной точки и не предоставляет дополнительных или специальных служб для конечной точки; он просто предоставляет ярлык для вызова API.

Примечание

Указание конечной точки в . Определение интерфейса IDL не ограничивает доступ к интерфейсу указанной конечной точкой. Добавление конечной точки в . Определение интерфейса IDL позволяет вызывать интерфейс через любую конечную точку в этом процессе и позволяет использовать конечную точку для вызова других интерфейсов в этом процессе.

 

Значение последовательности протокола определяет допустимые значения для порта конечной точки. Компилятор MIDL проверяет только общий синтаксис для записи порта конечной точки . Об ошибках спецификации портов сообщают библиотеки времени выполнения. Сведения о допустимых значениях для каждой последовательности протоколов см. в разделе Константы последовательности протоколов.

Компилятор MIDL, поставляемый с Microsoft RPC, не поддерживает следующие последовательности протоколов, заданные DCE: ncacn_osi_dna и ncadg_dds.

Убедитесь, что в конечных точках правильно указаны символы обратной косой черты. Эта ошибка обычно возникает, когда конечная точка является именованным каналом.

Сведения о конечной точке, указанные в IDL-файле, используются функциями среды выполнения RPC RpcServerUseProtseqIf и RpcServerUseAllProtseqsIf.

Примеры

endpoint("ncacn_np:[\\pipe\\rainier]") 

endpoint("ncacn_ip_tcp:[1044]", "ncacn_np:[\\pipe\\shasta]")

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

Файл определения интерфейса (IDL)

RpcServerUseAllProtseqsIf

RpcServerUseProtseqIf