atributo ncacn_np

  • Artigo

O ncacn_np palavra-chave identifica pipes nomeados como a família de protocolos para o ponto de extremidade.

endpoint("ncacn_np:server-name[\\pipe\\pipe-name]")

Parâmetros

nome do servidor

Opcional. Especifica o nome do servidor. Caracteres de barra invertida são opcionais.

pipe-name

Especifica um nome de pipe válido. Um nome de pipe válido é uma cadeia de caracteres que contém identificadores separados por caracteres de barra invertida. O primeiro identificador deve ser pipe. Cada identificador deve ser separado por dois caracteres de barra invertida.

Comentários

Um servidor cria uma instância de um pipe nomeado que, em seguida, está disponível para qualquer cliente. Quando um cliente tenta se conectar, a instância existente é associada a esse cliente. Antes que outro cliente possa se conectar, o servidor deve criar outra instância do pipe nomeado. Se um cliente tentar associar ao servidor antes que a nova instância seja criada, a chamada de associação , RpcBindingFromStringBinding, poderá falhar com a mensagem de erro RPC_S_SERVER_TOO_BUSY. Portanto, você precisa verificar se o aplicativo cliente lida com o caso em que o servidor está muito ocupado para aceitar uma conexão. O cliente deve tentar novamente automaticamente, solicitar ao usuário um curso de ação ou falhar normalmente.

A sintaxe da cadeia de caracteres de porta de pipe nomeado, como todas as cadeias de caracteres de porta, é definida pela implementação de transporte e é independente da especificação de IDL. O compilador MIDL executa verificação de sintaxe limitada, mas não garante que a especificação do ponto de extremidade esteja correta. Algumas classes de erros podem ser relatadas em tempo de execução em vez de em tempo de compilação.

Exemplos

[
    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.
}

Confira também

Extremidade

Arquivo IDL (definição de interface)

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

associação de cadeia de caracteres