attributo ncacn_np
La parola chiave ncacn_np identifica le pipe denominate come famiglia di protocolli per l'endpoint.
endpoint("ncacn_np:server-name[\\pipe\\pipe-name]")
Parametri
-
server-name
-
Facoltativa. Specifica il nome del server. I caratteri della barra rovesciata sono facoltativi.
-
pipe-name
-
Specifica un nome di pipe valido. Un nome della pipe valido è una stringa contenente identificatori separati da caratteri barra rovesciata. Il primo identificatore deve essere pipe. Ogni identificatore deve essere separato da due caratteri barra rovesciata.
Commenti
Un server crea un'istanza di una pipe denominata che è quindi disponibile per qualsiasi client. Quando un client tenta di connettersi, l'istanza esistente è associata a tale client. Prima che un altro client possa connettersi, il server deve creare un'altra istanza della pipe denominata. Se un client tenta di eseguire l'associazione al server prima della creazione della nuova istanza, la chiamata di associazione RpcBindingFromStringBinding potrebbe non riuscire con il messaggio di errore RPC_S_SERVER_TOO_BUSY. È quindi necessario assicurarsi che l'applicazione client gestisca il caso in cui il server sia troppo occupato per accettare una connessione. Il client deve riprovare automaticamente, richiedere all'utente un corso di azione o non riuscire correttamente.
La sintassi della stringa di porta denominata-pipe, come tutte le stringhe di porta, è definita dall'implementazione del trasporto ed è indipendente dalla specifica IDL. Il compilatore MIDL esegue il controllo della sintassi limitato, ma non garantisce che la specifica dell'endpoint sia corretta. Alcune classi di errori possono essere segnalate in fase di esecuzione anziché in fase di compilazione.
Esempi
[
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.
}
Vedere anche