struktur FILE_PIPE_INFORMATION (ntifs.h)

  • Artikel

Struktur FILE_PIPE_INFORMATION berisi informasi tentang pipa bernama yang tidak spesifik untuk ujung lokal atau jarak jauh pipa.

Sintaks

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

Anggota

ReadMode

Salah satu nilai berikut.

Nilai Makna
FILE_PIPE_BYTE_STREAM_MODE (0x00000000) Data dibaca dari pipa sebagai aliran byte.
FILE_PIPE_MESSAGE_MODE (0x00000001) Data dibaca dari pipa sebagai aliran pesan.

CompletionMode

Salah satu nilai berikut.

Nilai Makna
FILE_PIPE_QUEUE_OPERATION (0x00000000) Mode pemblokiran
FILE_PIPE_COMPLETE_OPERATION (0x00000001) Mode non-pemblokiran

Keterangan

Jika ReadMode diatur ke FILE_PIPE_BYTE_STREAM_MODE, setiap upaya untuk mengubahnya harus gagal dengan kode kesalahan STATUS_INVALID_PARAMETER.

Ketika CompletionMode diatur ke FILE_PIPE_QUEUE_OPERATION, jika pipa terhubung ke, dibaca ke, atau ditulis dari, operasi tidak selesai sampai ada data untuk dibaca, semua data ditulis, atau klien terhubung.

Catatan Nilai FILE_PIPE_QUEUE_OPERATION untuk CompletionMode dapat mengakibatkan menunggu tanpa batas waktu bagi proses klien untuk melakukan tindakan.
 
Ketika CompletionMode diatur ke FILE_PIPE_COMPLETE_OPERATION, jika pipa sedang disambungkan, dibaca ke, atau ditulis dari, operasi segera selesai.

Untuk informasi tentang pipa, lihat Pipa.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000
Header ntifs.h (termasuk FltKernel.h, Ntifs.h)