endpoint

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

protocol-sequence

Specifies a character string that represents a valid combination of an RPC protocol (such as "ncacn"), a transport protocol (such as "tcp"), and a network protocol (such as "ip"). Microsoft RPC supports the following protocol sequences:

Protocol sequence	Description	Supporting Platforms
ncacn_nb_tcp	Connection-oriented NetBIOS over TCP	Client and server: Windows NT Client only: MS-DOS, Windows 3.x™
ncacn_nb_ipx	Connection-oriented NetBIOS over IPX	Client and server: Windows NT Client : MS-DOS, Windows 3.x
ncacn_nb_nb	Connection-oriented NetBEUI	Client and server: Windows NT, Windows® 95 Client : MS-DOS, Windows 3.x
ncacn_ip_tcp	Connection-oriented TCP/IP	Client and server: Windows 95 and Windows NT Client: MS-DOS,Windows 3.x, and Apple® Macintosh®
ncacn_np	Connection-oriented named pipes	Client and server: Windows NT Client: MS-DOS, Windows 3.x, Windows 95
ncacn_spx	Connection-oriented SPX	Client and server: Windows NT, Windows 95 Client: MS-DOS, Windows 3.x
ncacn_dnet_nsp	Connection-oriented DECnet	Client only: MS-DOS, Windows 3.x
ncacn_at_dsp	Connection-oriented AppleTalk DSP	Server: Windows NT Client: Apple Macintosh
ncacn_vns_spp	Connection-oriented Vines SPP	Client and server: Windows NT Client: MS-DOS, Windows 3.x
ncadg_mq	Datagram (connectionless) over the Microsoft Message Queue Server	client only: Windows 95 (DCOM version) client and server: Windows NT version 4.0, with SP3, and later
ncacn_http	Connection-oriented TCP/IP using Microsoft Internet Information Server as HTTP proxy.	client only: Windows 95 (DCOM version) client and server: Windows NT version 5.0 and later
ncadg_ip_udp	Datagram (connectionless) UDP/IP	Client and server: Windows NT Client: MS-DOS, Windows 3.x
ncadg_ipx	Datagram (connectionless) IPX	Client and server: Windows NT Client: MS-DOS, Windows 3.x
ncalrpc	Local procedure call	Client and server: Windows NT and Windows 95

endpoint-port

Specifies a string that represents the endpoint designation for the specified protocol family. The syntax of the port string is specific to each protocol sequence.

Examples

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

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

Remarks

The endpoint attribute specifies a well-known port or ports (communication endpoints) on which servers of the interface listen for calls.

The endpoint specifies a transport family such as the TCP/IP connection-oriented protocol, a NetBIOS connection-oriented protocol, or the named-pipe connection-oriented protocol.

The protocol-sequence value determines the valid values for the endpoint-port. The MIDL compiler checks only general syntax for the endpoint-port entry. Port specification errors are reported by the run-time libraries. For information about the allowed values for each protocol sequence, see the topic for that protocol sequence.

The following protocol sequences specified by DCE are not supported by the MIDL compiler provided with Microsoft RPC: ncacn_osi_dna and ncadg_dds.

Make sure that you correctly quote backslash characters in endpoints. This error commonly occurs when the endpoint is a named pipe. Endpoint information specified in the IDL file is used by the RPC run-time functions RpcServerUseProtseqIf and RpcServerUseAllProtseqsIf.

See Also

IDL