共用方式為


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 (include FltKernel.h, Ntifs.h)