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 un flujo 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

Observaciones

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 completedMode se establece en FILE_PIPE_QUEUE_OPERATION, si la canalización está conectada a, lee o escribe desde, la operación no se completa hasta que haya datos que 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 que un proceso de cliente espere indefinidamente a realizar una acción.
 
Cuando completedMode se establece en FILE_PIPE_COMPLETE_OPERATION, si la canalización se conecta, lee o escribe desde, la operación se completa inmediatamente.

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

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000
encabezado de ntifs.h (include FltKernel.h, Ntifs.h)