Атрибут конечной точки
Атрибут [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]")
См. также раздел