attributo endpoint
L'attributo [endpoint] specifica una porta o porte note (endpoint di comunicazione) in cui i server dell'interfaccia sono in ascolto delle chiamate.
endpoint("protocol-sequence:[endpoint-port]" [ , ...] )
Parametri
-
sequenza di protocollo
-
Specifica una stringa di caratteri che rappresenta una combinazione valida di un protocollo RPC (ad esempio "ncacn"), un protocollo di trasporto (ad esempio "tcp") e un protocollo di rete (ad esempio "ip"). Per un elenco di sequenze di protocolli valide, vedere Costanti della sequenza di protocollo.
-
endpoint-port
-
Specifica una stringa che rappresenta la designazione dell'endpoint per la famiglia di protocolli specificata. La sintassi della stringa di porta è specifica per ogni sequenza di protocollo.
Commenti
L'attributo [endpoint] specifica una famiglia di trasporto, ad esempio il protocollo orientato alla connessione TCP/IP, un protocollo orientato alla connessione NetBIOS o il protocollo orientato alla connessione named-pipe. L'uso dell'attributo [endpoint] è coerente con altri metodi per l'aggiunta di un endpoint e non fornisce servizi aggiuntivi o speciali per l'endpoint; fornisce semplicemente un collegamento per chiamare l'API.
Nota
Specifica di un endpoint in . La definizione dell'interfaccia IDL non limita l'accesso all'interfaccia all'endpoint specificato. Aggiunta di un endpoint a . La definizione dell'interfaccia IDL consente di chiamare l'interfaccia tramite qualsiasi endpoint in tale processo e consente l'uso dell'endpoint per chiamare altre interfacce in tale processo.
Il valore della sequenza di protocollo determina i valori validi per la porta dell'endpoint. Il compilatore MIDL controlla solo la sintassi generale per la voce della porta endpoint . Gli errori di specifica delle porte vengono segnalati dalle librerie di runtime. Per informazioni sui valori consentiti per ogni sequenza di protocollo, vedere Le costanti della sequenza di protocollo.
Le sequenze di protocollo seguenti specificate da DCE non sono supportate dal compilatore MIDL fornito con Microsoft RPC: ncacn_osi_dna e ncadg_dds.
Assicurarsi di inserire correttamente le virgolette rovesciata negli endpoint. Questo errore si verifica in genere quando l'endpoint è una named pipe.
Le informazioni sull'endpoint specificate nel file IDL vengono usate dalle funzioni di runtime RPC RpcServerUseProtseqIf e RpcServerUseAllProtseqsIf.
Esempi
endpoint("ncacn_np:[\\pipe\\rainier]")
endpoint("ncacn_ip_tcp:[1044]", "ncacn_np:[\\pipe\\shasta]")
Vedere anche