函数参考


_NamedPipes_CreateNamedPipe

创建一个命名管道接口(instance)

#Include <NamedPipes.au3>
_NamedPipes_CreateNamedPipe($sName[, $iAccess = 2[, $iFlags = 2[, $iACL = 0[, $iType = 1[, $iRead = 1[, $iWait = 0[, $iMaxInst = 25[, $iOutBufSize = 4096[, $iInpBufSize = 4096[, $iDefTimeout = 5000[, $pSecurity = 0]]]]]]]]]]])

参数

$sName 管道名称有下列格式: \\.\pipe\pipename. The pipename part of the name can
该名称的管道名称部分除反斜杠外,可以包含任何字符, 包括数字和特殊字符.
管道名称字符串最多可以有 256 个字符. 管道名称不区分大小写.
$iAccess [可选参数] 管道接入方式. 必须是下列值之一:
0 - 管道中的数据流仅从客户端到服务器(入站)
1 - 管道中的数据流仅从服务器到客户端(出站)
2 - 管道是双向的(双工)
$iFlags [可选参数] 管道标志.可以是任何以下组合:
1 - 如果您尝试创建此标志管道的多个实例,
第一个实例创建成功,但下一个实例创建将失败.
2 - 启用重叠模式.如果这个模式被激活,函数履行读,写与连接操作,
这可能需要大量的时间才能完成(可以立即返回).
4 - 启用连续写入模式.该模式只影响字节类型管道的写操作,
且仅当客户端和服务器在不同计算机上.
$iACL [可选参数] 安全 ACL 标志.可以是任何以下值得组合:
1 - 调用方将具有写访问命名管道自由裁量的 ACL
2 - 调用方将具有写访问命名管道的所有者
4 - 调用方将具有写访问命名管道的安全的ACL
$iType [可选参数] 管道类型模式.必须是下列之一:
0 - 以字节流向管道写入数据
1 - 以消息流向管道写入数据
$iRead [可选参数] 管道读模式.必须是下列之一
0 - 以字节流从管道读取数据
1 - 以消息流从管道读取数据
$iWait [可选参数] 管道等待模式.必须是下列之一
0 - 启用阻塞模式.当管道句柄由 ReadFile, WriteFile, 或 ConnectNamedPipe 指定时,
操作未完成,直到有数据读取,写入所有数据,或者一个客户端连接.
1 - 启用非阻塞模式.ReadFile,WriteFile 与 ConnectNamedPipe 总是立即返回.
$iMaxInst [可选参数] 管道可创建实例的最大数量
$iOutBufSize [可选参数] 输出缓冲区保留的字节数
$iInpBufSize [可选参数] 输入缓冲区保留的字节数
$iDefTimeOut [可选参数] 默认的超时值,以毫秒为单位
$pSecurity [可选参数] tagSECURITY_ATTRIBUTES 结构指针,它指定新命名管道的安全描述符,并确定是否可以继承子进程返回的句柄
如果 pSecurity 为0,命名管道获取默的安全描述符,且句柄不能被继承
命名管道授予 LocalSystem 帐户管理员与创建者属主默认完全控制的安全描述符的 ACL
命名管道授予 LocalSystem 帐户管理员与创建者属主默认完全控制的安全描述符的 ACL
还授予读取访问 Everyone 组成员和匿名帐户.

返回值

成功: 服务器端命名管道实例句柄
失败: 返回 -1

注意/说明

None.

相关

_NamedPipes_ConnectNamedPipe, _NamedPipes_CreatePipe

详情参考

在MSDN中搜索