FILE_PIPE_LOCAL_INFORMATION結構 (ntifs.h)
FILE_PIPE_LOCAL_INFORMATION 結構包含具名管道本機結尾的相關信息。
語法
typedef struct _FILE_PIPE_LOCAL_INFORMATION {
ULONG NamedPipeType;
ULONG NamedPipeConfiguration;
ULONG MaximumInstances;
ULONG CurrentInstances;
ULONG InboundQuota;
ULONG ReadDataAvailable;
ULONG OutboundQuota;
ULONG WriteQuotaAvailable;
ULONG NamedPipeState;
ULONG NamedPipeEnd;
} FILE_PIPE_LOCAL_INFORMATION, *PFILE_PIPE_LOCAL_INFORMATION;
成員
NamedPipeType
下列其中一個命名管道類型。
| 值 | 意義 |
|---|---|
| FILE_PIPE_BYTE_STREAM_TYPE (0x00000000) | 數據會以位元組數據流的形式從管道讀取。 |
| FILE_PIPE_MESSAGE_TYPE (0x00000001) | 數據會從管道讀取為訊息數據流。 |
NamedPipeConfiguration
下列其中一個命名管道組態。
| 值 | 意義 |
|---|---|
| FILE_PIPE_INBOUND (0x00000000) | 管道中的數據流程只會從用戶端流向伺服器。 |
| FILE_PIPE_OUTBOUND (0x00000001) | 管道中的數據流程只會從伺服器流向用戶端。 |
| FILE_PIPE_FULL_DUPLEX (0x00000002) | 管道是雙向的;伺服器和客戶端進程都可以讀取和寫入管道。 |
MaximumInstances
可為此管道建立的實例數目上限。 管道的第一個實例必須指定此值。
CurrentInstances
目前命名管道實例的數目。
InboundQuota
命名管道的輸入配額，以位元組為單位。
ReadDataAvailable
要從命名管道讀取的數據量，以位元組為單位。
OutboundQuota
命名管道的輸出配額，以位元組為單位。
WriteQuotaAvailable
命名管道的寫入配額，以位元組為單位。
NamedPipeState
命名管道的連接狀態。 此狀態具有下列其中一個值。
| 值 | 意義 |
|---|---|
| FILE_PIPE_DISCONNECTED_STATE (0x00000001) | 命名管道已中斷連線。 |
| FILE_PIPE_LISTENING_STATE (0x00000002) | 命名管道正在等候建立連線。 |
| FILE_PIPE_CONNECTED_STATE (0x00000003) | 命名管道已連接。 |
| FILE_PIPE_CLOSING_STATE (0x00000004) | 命名管道正在關閉。 |
NamedPipeEnd
命名管道結尾的類型，指定這是命名管道的用戶端或伺服器端。
| 值 | 意義 |
|---|---|
| FILE_PIPE_CLIENT_END (0x00000000) | 這是命名管道的用戶端端。 |
| FILE_PIPE_SERVER_END (0x00000001) | 這是命名管道的伺服器端。 |
備註
如需管道的相關信息，請參閱 管道。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 |
| 標頭 | ntifs.h (包含 FltKernel.h、Ntifs.h) |