atributo ncacn_np
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