ncacn_np 属性

ncacn_np关键字 (keyword) 将命名管道标识为终结点的协议系列。

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

参数

server-name

可选。 指定服务器的名称。 反斜杠字符是可选的。

pipe-name

指定有效的管道名称。 有效的管道名称是包含用反斜杠字符分隔的标识符的字符串。 第一个标识符必须是 管道。 每个标识符必须用两个反斜杠字符分隔。

备注

服务器创建命名管道的实例,该实例随后可供任何客户端使用。 当客户端尝试连接时,现有实例与该客户端相关联。 在另一个客户端可以连接之前,服务器必须创建命名管道的另一个实例。 如果在创建新实例之前,客户端尝试绑定到服务器,绑定调用 RpcBindingFromStringBinding 可能会失败,并显示错误消息RPC_S_SERVER_TOO_BUSY。 因此,需要确保客户端应用程序处理服务器太忙而无法接受连接的情况。 客户端应自动重试、提示用户执行操作或正常失败。

与所有端口字符串一样,命名管道端口字符串的语法由传输实现定义,并且独立于 IDL 规范。 MIDL 编译器执行有限的语法检查,但不保证终结点规范正确。 某些类错误可能会在运行时报告,而不是在编译时报告。

示例

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

另请参阅

端点

接口定义 (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

字符串绑定