CallNamedPipe函式由一個希望通過管道通信的一個客戶進程調用。如有可能,它就同一個管道連線(在必要的情況下等候管道可用)。隨後,它對指定的數據進行讀寫,然後將管道關閉。
基本介紹
- 中文名:CallNamedPipe
- 外文名:CallNamedPipe
- 學科:計算機學
- 解釋:VB程式
定義,參數說明,返回值,參數表,
定義
Declare Function CallNamedPipe Lib "kernel32" Alias "CallNamedPipeA" (ByVal lpNamedPipeName As String, lpInBuffer As Any, ByVal nInBufferSize As Long, lpOutBuffer As Any, ByVal nOutBufferSize As Long, lpBytesRead As Long, ByVal nTimeOut As Long) As Long
參數說明
返回值
Long,非零表示成功,零表示失敗。如果要獲取錯誤信息,請調用GetLastError。
參數表
參數 類型及說明
lpNamedPipeName String,欲打開管道的名稱
lpInBuffer Any,包含了要寫入管道的數據的一個記憶體緩衝區
nInBufferSize Long,lpInBuffer緩衝區中的字元數量
lpOutBuffer Any,指定一個記憶體緩衝區,用於裝載從管道中讀出的數據
nOutBufferSize Long,指定一個長整數變數,用於裝載來自管道的數據
lpBytesRead Long,指定從管道中讀出的位元組數。會閱讀單條訊息。如lpOutBuffer的容量不夠大,不能容下整條訊息,則函式會返回FALSE,而且GetLastError會設為ERROR_MORE_DATA(訊息中留下的任何位元組都會丟失)
nTimeOut Long,下述常量之一:
NMPWAIT_NOWAIT 如管道不可用,則立即返回一個錯誤
NMPWAIT_WAIT_FOREVER 永遠等候管道可用
NMPWAIT_USE_DEFAULT_WAIT 使用管道的默認逾時設定,這個設定是用CreateNamedPipe函式指定的