atributo ncacn_np
La palabra clave ncacn_np identifica canalizaciones con nombre como la familia de protocolos para el punto de conexión.
endpoint("ncacn_np:server-name[\\pipe\\pipe-name]")
Parámetros
-
server-name
-
Opcional. Especifica el nombre del servidor. Los caracteres de barra diagonal inversa son opcionales.
-
pipe-name
-
Especifica un nombre de canalización válido. Un nombre de canalización válido es una cadena que contiene identificadores separados por caracteres de barra diagonal inversa. El primer identificador debe ser canalización. Cada identificador debe estar separado por dos caracteres de barra diagonal inversa.
Comentarios
Un servidor crea una instancia de una canalización con nombre que, a continuación, está disponible para cualquier cliente. Cuando un cliente intenta conectarse, la instancia existente está asociada a ese cliente. Para que otro cliente pueda conectarse, el servidor debe crear otra instancia de la canalización con nombre. Si un cliente intenta enlazar al servidor antes de crear la nueva instancia, la llamada de enlace RpcBindingFromStringBinding puede producir un error con el mensaje de error RPC_S_SERVER_TOO_BUSY. Por lo tanto, debe asegurarse de que la aplicación cliente controla el caso en el que el servidor está demasiado ocupado para aceptar una conexión. El cliente debe reintentar automáticamente, solicitar al usuario un curso de acción o producir un error correctamente.
La sintaxis de la cadena de puerto de canalización con nombre, como todas las cadenas de puerto, se define mediante la implementación de transporte y es independiente de la especificación IDL. El compilador MIDL realiza comprobaciones de sintaxis limitadas, pero no garantiza que la especificación del punto de conexión sea correcta. Algunas clases de errores se pueden notificar en tiempo de ejecución en lugar de en tiempo de compilación.
Ejemplos
[
uuid(12345678-4000-2006-0000-20000000001a),
version(1.1),
endpoint("ncacn_np:[\\pipe\\stove\\hat]")
]
interface iface1
{
// Interface definition statements.
}
[
uuid(87654321-4000-2006-0000-20000000001b),
version(1.1),
endpoint("ncacn_np:\\\\myotherserver[\\pipe\\corncob]")
]
interface iface2
{
// Interface definition statements.
}
Vea también