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

説明

返回值

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_TYPE_MESSAGE 數據用數據塊（名為“消息”或“報文”）的形式寫入管道

下述常數之一：

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