基本介紹
- 外文名：CreateNamedPipe
- 說明：創建一個命名管道
- 適用平台：Windows NT
- 執行成功：返回管道的句柄
簡介,適用平台,
簡介
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
說明
返回值
Long，如執行成功，返回管道的句柄。INVALID_HANDLE_VALUE表示失敗。會設定GetLastError
參數表
參數 類型及說明
lpName String，指定管道名，採用的形式是：\\.\管道\管道名。最多可達256個字元的長度，而且不用區分大小寫。如果存在指定名字的一個管道，則創建那個管道的一個新實例
dwOpenMode Long，下述常數組的一個組合
下述常數之一（對於管道的所有實例都要一樣）：
PIPE_ACCESS_DUPLEX 管道是雙向的
PIPE_ACCESS_INBOUND 數據從客戶端流到伺服器端
PIPE_ACCESS_OUTBOUND 數據從伺服器端流到客戶端
下述常數的任意組合
FILE_FLAG_WRITE_THROUGH 在網路中建立的位元組型管道內，強迫數據在每次讀寫操作的時候通過網路傳輸。否則傳輸就可能延遲
FILE_FLAG_OVERLAPPED 允許（但不要求）用這個管道進行異步（重疊式）操作
常數WRITE_DAC， WRITE_OWNER 和 ACCESS_ SYSTEM_SECURITY提供了附加的安全選項
dwPipeMode Long，下述常數組的一個組合：
下述常數之一（管道的所有實例都必須指定相同的常數）
PIPE_TYPE_BYTE 數據作為一個連續的位元組數據流寫入管道
下述常數之一：
PIPE_READMODE_BYTE 數據以單獨位元組的形式從管道中讀出
PIPE_READMODE_MESSAGE 數據以名為“訊息”的數據塊形式從管道中讀出（要求指定PIPE_TYPE_MESSAGE）
下述常數之一：
PIPE_WAIT 同步操作在等待的時候掛起執行緒
PIPE_NOWAIT（不推薦！） 同步操作立即返回。這樣可為異步傳輸提供一種落後的實現方法，已由Win32的重疊式傳輸機製取代了
nMaxInstances Long，這個管道能夠創建的最大實例數量。必須是1到常數PIPE_UNLIMITED_INSTANCES間的一個值。它對於管道的所有實例來說都應是相同的
nOutBufferSize Long，建議的輸出緩衝區長度；零表示用默認設定
nInBufferSize Long，建議的輸入緩衝區長度；零表示用默認設定
nDefaultTimeOut Long，管道的默認等待逾時。對一個管道的所有實例來說都應相同
lpSecurityAttributes SECURITY_ATTRIBUTES，指定一個SECURITY_ATTRIBUTES結構，或者傳遞零值（將參數聲明為ByVal As Long，並傳遞零值），以便使用不允許繼承的一個默認描述符
適用平台
Windows NT
