Endpunktattribute
Das Attribut [endpunkt] gibt einen bekannten Port (Kommunikationsendpunkte) an, an dem 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 Protokollsequenzkonstanten.
-
endpunkt-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 Attribut [endpunkt] gibt eine Transportfamilie an, z. B. das TCP/IP-verbindungsorientierte Protokoll, ein verbindungsorientiertes NetBIOS-Protokoll oder das verbindungsorientierte Named-Pipe-Protokoll. Die Verwendung des [endpunkt]- Attributs ist mit anderen Methoden zum Hinzufügen eines Endpunkts konsistent und stellt keine zusätzlichen oder speziellen Dienste für den Endpunkt bereit. Es stellt einfach eine Verknüpfung zum Aufrufen der API bereit.
Hinweis
Angeben eines Endpunkts in . Die IDL-Schnittstellendefinition beschränkt den Zugriff auf die Schnittstelle nicht auf den angegebenen Endpunkt. Hinzufügen eines Endpunkts zu . Mithilfe 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 Protokollsequenzkonstanten.
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 umgekehrte Schrägstriche in Endpunkten korrekt zitieren. Dieser Fehler tritt häufig auf, wenn der Endpunkt eine Named Pipe ist.
Endpunktinformationen, die in der IDL-Datei angegeben sind, 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