Endpunktattribut

Das [ ] Endpunktattribut gibt einen bzw. mehrere bekannte Ports (Kommunikationsendpunkte) an, an denen Server der Schnittstelle auf Aufrufe lauschen.

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

Parameter

Protokollsequenz

Gibt eine Zeichenfolge an, die eine gültige Kombination aus einem RPC-Protokoll (z. B. "ncacn"), einem Transportprotokoll (z.B. "tcp") und einem Netzwerkprotokoll (z. B. "ip") darstellt. Eine Liste der gültigen Protokollsequenzen finden Sie unter Protokollsequenzkonst constants.

endpoint-port

Gibt eine Zeichenfolge an, die die Endpunktbezeichnung für die angegebene Protokollfamilie darstellt. Die Syntax der Portzeichenfolge ist für jede Protokollsequenz spezifisch.

Bemerkungen

Das [ ] Endpunktattribut gibt eine Transportfamilie an, z. B. das tcp/IP-verbindungsorientierte Protokoll, ein netBIOS-verbindungsorientiertes Protokoll oder das verbindungsorientierte Named Pipe-Protokoll. Die Verwendung des [ ] Endpunktattributs ist konsistent mit anderen Methoden zum Hinzufügen eines Endpunkts und stellt keine zusätzlichen oder speziellen Dienste für den Endpunkt bereit. Es stellt lediglich eine Verknüpfung zum Aufrufen der API bereit.

Hinweis

Angeben eines Endpunkts in der . Die Definition der IDL-Schnittstelle schränkt den Zugriff auf die Schnittstelle auf den angegebenen Endpunkt nicht ein. Hinzufügen eines Endpunkts zum . Mit der IDL-Schnittstellendefinition kann die Schnittstelle über einen beliebigen Endpunkt in diesem Prozess aufgerufen werden, und der Endpunkt kann zum Aufrufen anderer Schnittstellen in diesem Prozess verwendet werden.

Der Protokollsequenzwert bestimmt die gültigen Werte für den Endpunktport. Der MIDL-Compiler überprüft nur die allgemeine Syntax für den Endpunktporteintrag. Portspezifikationsfehler werden von den Laufzeitbibliotheken gemeldet. Informationen zu den zulässigen Werten für jede Protokollsequenz finden Sie unter Protokollsequenzkonst constants.

Die folgenden von DCE angegebenen Protokollsequenzen werden vom MIDL-Compiler, der mit Microsoft RPC bereitgestellt wird, nicht unterstützt: ncacn _ osi _ dna und ncadg _ dds.

Stellen Sie sicher, dass Sie schräge Schrägstriche in Endpunkten richtig anführungszeichen anführungszeichen. Dieser Fehler tritt häufig auf, wenn der Endpunkt eine Named Pipe ist.

Die in der IDL-Datei angegebenen Endpunktinformationen werden von den RPC-Laufzeitfunktionen RpcServerUseProtseqIf und RpcServerUseAllProtseqsIf verwendet.

Beispiele

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

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

Weitere Informationen

IDL-Datei (Interface Definition)

RpcServerUseAllProtseqsIf

RpcServerUseProtseqIf