Compartir a través de

estructura FILE_PIPE_INFORMATION (ntifs.h)

  • Artículo

La estructura FILE_PIPE_INFORMATION contiene información sobre una canalización con nombre que no es específica del extremo local o remoto de la canalización.

Sintaxis

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

Miembros

ReadMode

Uno de los siguientes valores.

Valor Significado
FILE_PIPE_BYTE_STREAM_MODE (0x00000000) Los datos se leen desde la canalización como una secuencia de bytes.
FILE_PIPE_MESSAGE_MODE (0x00000001) Los datos se leen desde la canalización como un flujo de mensajes.

CompletionMode

Uno de los siguientes valores.

Valor Significado
FILE_PIPE_QUEUE_OPERATION (0x00000000) Modo de bloqueo
FILE_PIPE_COMPLETE_OPERATION (0x00000001) Modo de no bloqueo

Comentarios

Si ReadMode está establecido en FILE_PIPE_BYTE_STREAM_MODE, cualquier intento de cambiarlo debe producir un error con un código de error STATUS_INVALID_PARAMETER.

Cuando CompletionMode se establece en FILE_PIPE_QUEUE_OPERATION, si la canalización está conectada, leída o escrita desde, la operación no se completa hasta que hay datos que se van a leer, se escriben todos los datos o se conecta un cliente.

Nota Un valor de FILE_PIPE_QUEUE_OPERATION para CompletionMode puede dar lugar a una espera indefinida para que un proceso de cliente realice una acción.
 
Cuando CompletionMode se establece en FILE_PIPE_COMPLETE_OPERATION, si la canalización se está conectando, lee o escribe desde, la operación se completa inmediatamente.

Para obtener información sobre las canalizaciones, consulte Canalizaciones.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000
Encabezado ntifs.h (incluya FltKernel.h, Ntifs.h)