共用方式為

FILE_PIPE_INFORMATION結構 (ntifs.h)

  • 發行項

FILE_PIPE_INFORMATION 結構包含命名管道的相關信息，該管道不是管道的本機或遠端端點。

語法

typedef struct _FILE_PIPE_INFORMATION {
  ULONG ReadMode;
  ULONG CompletionMode;
} FILE_PIPE_INFORMATION, *PFILE_PIPE_INFORMATION;

成員

ReadMode

下列其中一個值。

值 意義
FILE_PIPE_BYTE_STREAM_MODE (0x00000000) 數據會以位元組數據流的形式從管道讀取。
FILE_PIPE_MESSAGE_MODE (0x00000001) 數據會從管道讀取為訊息數據流。

CompletionMode

下列其中一個值。

值 意義
FILE_PIPE_QUEUE_OPERATION (0x00000000) 封鎖模式
FILE_PIPE_COMPLETE_OPERATION (0x00000001) 非封鎖模式

備註

如果 ReadMode 設定為 FILE_PIPE_BYTE_STREAM_MODE，則任何變更嘗試都必須失敗，並出現STATUS_INVALID_PARAMETER錯誤碼。

當 CompletionMode 設定為 FILE_PIPE_QUEUE_OPERATION時，如果管道已連接、讀取或寫入，則在讀取數據、寫入所有數據或用戶端連線之前，作業都不會完成。

注意CompletionMode 的FILE_PIPE_QUEUE_OPERATION值可能會導致無限期等候客戶端進程執行動作。
 
當 CompletionMode 設定為 FILE_PIPE_COMPLETE_OPERATION時，如果管道正在連接、讀取或寫入，作業就會立即完成。

如需管道的相關信息，請參閱 管道。

規格需求

需求 值
最低支援的用戶端 Windows 2000
標頭 ntifs.h (包含 FltKernel.h、Ntifs.h)