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 值可能會導致無限期等候客戶端進程執行動作。
如需管道的相關信息,請參閱 管道。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 |
標頭 | ntifs.h (include FltKernel.h, Ntifs.h) |