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

Extremo

Archivo de definición de interfaz (IDL)

ncacn_at_dsp

ncacn_dnet_nsp

ncacn_ip_tcp

ncacn_nb_ipx

ncacn_spx

ncacn_nb_nb

ncacn_nb_tcp

ncacn_vns_spp

ncalrpc

ncadg_ipx

ncadg_ip_udp

enlace de cadena