WaitNamedPipe

nTimeOut 等待命名管道的一個實例有效的逾時時間，單位毫秒，也可以使用下面兩個值中的一個：

NMPWAIT_USE_DEFAULT_WAIT 0x00000000,使用服務端CreateNamedPipe 創建管道時設定的逾時時間。

NMPWAIT_WAIT_FOREVER 0xffffffff，一直等到一個命名管道的實例有效才返回。

基本介紹

• 外文名：WaitNamedPipe
• 套用：C/C++
• 返回非0：在逾時時間前管道的一個實例有效
• 返回0：逾時時間內沒有一個有效的實例

聲明

C/C++聲明：

BOOL WaitNamedPipe(

LPCTSTR lpNamedPipeName,

DWORD nTimeOut

);

參數

lpNamedPipeName 要打開的管道名，格式\\servername\pipe\pipename，如果是本地管道則servername可以使用點“.”。

返回值：

如果在逾時時間前管道的一個實例有效，返回非0。

如果逾時時間內沒有一個有效的實例，返回0。

注意

如果指定的命名管道沒有實例存在，即沒有服務端創建該命名管道，函式無視逾時等待時間直接返回0。

如果函式執行成功返回TRUE，表示至少有一個命名管道的實例有效，接下來應該使用CreateFile函式打開命名管道的一個句柄，但是CreateFile可能會打開管道失敗，因為該實例有可能被服務端關閉或被已經被其他客戶端打開。