atributo endpoint
El atributo [endpoint] especifica un puerto o puertos conocidos (puntos de conexión de comunicación) en los que los servidores de la interfaz escuchan las llamadas.
endpoint("protocol-sequence:[endpoint-port]" [ , ...] )
Parámetros
-
secuencia de protocolos
-
Especifica una cadena de caracteres que representa una combinación válida de un protocolo RPC (como "ncacn"), un protocolo de transporte (como "tcp") y un protocolo de red (como "ip"). Para obtener una lista de secuencias de protocolo válidas, consulte Constantes de secuencia de protocolo.
-
endpoint-port
-
Especifica una cadena que representa la designación del punto de conexión para la familia de protocolos especificada. La sintaxis de la cadena de puerto es específica de cada secuencia de protocolo.
Comentarios
El atributo [endpoint] especifica una familia de transporte como el protocolo orientado a la conexión TCP/IP, un protocolo orientado a la conexión NetBIOS o el protocolo orientado a la conexión con nombre. El uso del atributo [endpoint] es coherente con otros métodos para agregar un punto de conexión y no proporciona servicios adicionales o especiales para el punto de conexión; simplemente proporciona un acceso directo para llamar a la API.
Nota
Especificar un punto de conexión en . La definición de la interfaz IDL no restringe el acceso a la interfaz al punto de conexión especificado. Agregar un punto de conexión a . La definición de la interfaz IDL permite llamar a la interfaz a través de cualquier punto de conexión de ese proceso y permite que el punto de conexión se use para llamar a otras interfaces en ese proceso.
El valor de secuencia de protocolo determina los valores válidos para el puerto de punto de conexión. El compilador MIDL comprueba solo la sintaxis general de la entrada endpoint-port . Las bibliotecas en tiempo de ejecución notifican errores de especificación de puerto. Para obtener información sobre los valores permitidos para cada secuencia de protocolo, vea Constantes de secuencia de protocolo.
El compilador MIDL proporcionado con Microsoft RPC no admite las siguientes secuencias de protocolo especificadas por DCE: ncacn_osi_dna y ncadg_dds.
Asegúrese de que comillas correctamente caracteres de barra diagonal inversa en puntos de conexión. Este error suele producirse cuando el punto de conexión es una canalización con nombre.
La información del punto de conexión especificada en el archivo IDL se usa en las funciones en tiempo de ejecución rpc RpcServerUseProtseqIf y RpcServerUseAllProtseqsIf.
Ejemplos
endpoint("ncacn_np:[\\pipe\\rainier]")
endpoint("ncacn_ip_tcp:[1044]", "ncacn_np:[\\pipe\\shasta]")
Vea también