DisconnectNamedPipe 函式 (namedpipeapi.h)

中斷命名管道實例的伺服器端與客戶端進程的連接。

語法

BOOL DisconnectNamedPipe(
  [in] HANDLE hNamedPipe
);

[in] hNamedPipe

具名管道實例的句柄。這個句柄必須由 CreateNamedPipe 函式建立。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

如果命名管道的用戶端已開啟， DisconnectNamedPipe 函式會強制關閉命名管道的結尾。用戶端下次嘗試存取管道時收到錯誤。 由 DisconnectNamedPipe 強制關閉管道的用戶端，仍然必須使用 CloseHandle 函式來關閉其管道的結尾。

只要伺服器或客戶端進程有管道的開啟句柄，管道就會存在。

當伺服器進程中斷管道實例的連接時，會捨棄管道中任何未讀取的數據。在中斷連線之前，伺服器可以呼叫 FlushFileBuffers 函式來確保數據不會遺失，在客戶端進程讀取所有數據之前不會傳回。

伺服器進程必須呼叫 DisconnectNamedPipe ，才能使用 ConnectNamedPipe 函式將管道句柄與先前的用戶端中斷連線，才能連接另一個用戶端。

Windows 10 版本 1709：管道僅支援於應用程式容器內;亦即，從一個 UWP 進程到屬於相同應用程式的另一個 UWP 進程。此外，命名管道必須使用管道名稱的語法 \\.\pipe\LOCAL\ 。

如需範例，請參閱多線程管道伺服器。

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	namedpipeapi.h
程式庫	Kernel32.lib
DLL	Kernel32.dll