CreateNamedPipe

CreateNamedPipe

VB聲明

Declare Function CreateNamedPipe Lib "kernel32" Alias "CreateNamedPipeA" (ByVal lpName As String, ByVal dwOpenMode As Long, ByVal dwPipeMode As Long, ByVal nMaxInstances As Long, ByVal nOutBufferSize As Long, ByVal nInBufferSize As Long, ByVal nDefaultTimeOut As Long, lpSecurityAttributes As SECURITY_ATTRIBUTES) As Long

說(shuō)明

創(chuàng)建一個(gè)命名管道。返回的句柄由管道的服務(wù)器端使用

返回值

Long，如執(zhí)行成功，返回管道的句柄。INVALID_HANDLE_VALUE表示失敗。會(huì)設(shè)置GetLastError

參數(shù)表

參數(shù)

類型及說(shuō)明

lpName

String，指定管道名，采用的形式是：\\.\管道\管道名。最多可達(dá)256個(gè)字符的長(zhǎng)度，而且不用區(qū)分大小寫。如果存在指定名字的一個(gè)管道，則創(chuàng)建那個(gè)管道的一個(gè)新實(shí)例

dwOpenMode

Long，下述常數(shù)組的一個(gè)組合

下述常數(shù)之一（對(duì)于管道的所有實(shí)例都要一樣）：

PIPE_ACCESS_DUPLEX

管道是雙向的

PIPE_ACCESS_INBOUND

數(shù)據(jù)從客戶端流到服務(wù)器端

PIPE_ACCESS_OUTBOUND

數(shù)據(jù)從服務(wù)器端流到客戶端

下述常數(shù)的任意組合

FILE_FLAG_WRITE_THROUGH

在網(wǎng)絡(luò)中建立的字節(jié)型管道內(nèi)，強(qiáng)迫數(shù)據(jù)在每次讀寫操作的時(shí)候通過(guò)網(wǎng)絡(luò)傳輸。否則傳輸就可能延遲

FILE_FLAG_OVERLAPPED

允許（但不要求）用這個(gè)管道進(jìn)行異步（重疊式）操作

常數(shù)WRITE_DAC， WRITE_OWNER 和 ACCESS_ SYSTEM_SECURITY提供了附加的安全選項(xiàng)

dwPipeMode

Long，下述常數(shù)組的一個(gè)組合：

下述常數(shù)之一（管道的所有實(shí)例都必須指定相同的常數(shù)）

PIPE_TYPE_BYTE

數(shù)據(jù)作為一個(gè)連續(xù)的字節(jié)數(shù)據(jù)流寫入管道

PIPE_TYPE_MESSAGE

數(shù)據(jù)用數(shù)據(jù)塊（名為“消息”或“報(bào)文”）的形式寫入管道

下述常數(shù)之一：

PIPE_READMODE_PIPE

數(shù)據(jù)以單獨(dú)字節(jié)的形式從管道中讀出

PIPE_READMODE_MESSAGE

數(shù)據(jù)以名為“消息”的數(shù)據(jù)塊形式從管道中讀出（要求指定PIPE_TYPE_MESSAGE）

下述常數(shù)之一：

PIPE_WAIT

同步操作在等待的時(shí)候掛起線程

PIPE_NOWAIT（不推薦?。?/span>

同步操作立即返回。這樣可為異步傳輸提供一種落后的實(shí)現(xiàn)方法，已由Win32的重疊式傳輸機(jī)制取代了

nMaxInstances

Long，這個(gè)管道能夠創(chuàng)建的最大實(shí)例數(shù)量。必須是1到常數(shù)PIPE_UNLIMITED_INSTANCES間的一個(gè)值。它對(duì)于管道的所有實(shí)例來(lái)說(shuō)都應(yīng)是相同的

nOutBufferSize

Long，建議的輸出緩沖區(qū)長(zhǎng)度；零表示用默認(rèn)設(shè)置

nInBufferSize

Long，建議的輸入緩沖區(qū)長(zhǎng)度；零表示用默認(rèn)設(shè)置

nDefaultTimeOut

Long，管道的默認(rèn)等待超時(shí)。對(duì)一個(gè)管道的所有實(shí)例來(lái)說(shuō)都應(yīng)相同

lpSecurityAttributes

SECURITY_ATTRIBUTES，指定一個(gè)SECURITY_ATTRIBUTES結(jié)構(gòu)，或者傳遞零值（將參數(shù)聲明為ByVal As Long，并傳遞零值），以便使用不允許繼承的一個(gè)默認(rèn)描述符

適用平臺(tái)

Windows NT

Top