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

Endpoint

File IDL (Interface Definition)

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

associazione di stringhe