FILE_PIPE_INFORMATION estrutura (ntifs.h)

A estrutura FILE_PIPE_INFORMATION contém informações sobre um pipe nomeado que não é específico do local ou da extremidade remota do pipe.

Sintaxe

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

Membros

ReadMode

Um dos valores a seguir.

Valor Significado
FILE_PIPE_BYTE_STREAM_MODE (0x00000000) Os dados são lidos do pipe como um fluxo de bytes.
FILE_PIPE_MESSAGE_MODE (0x00000001) Os dados são lidos do pipe como um fluxo de mensagens.

CompletionMode

Um dos valores a seguir.

Valor Significado
FILE_PIPE_QUEUE_OPERATION (0x00000000) Modo de bloqueio
FILE_PIPE_COMPLETE_OPERATION (0x00000001) Modo de não bloqueio

Comentários

Se ReadMode estiver definido como FILE_PIPE_BYTE_STREAM_MODE, qualquer tentativa de alterá-lo deverá falhar com um código de erro STATUS_INVALID_PARAMETER.

Quando CompletionMode estiver definido como FILE_PIPE_QUEUE_OPERATION, se o pipe estiver conectado, lido ou gravado, a operação não será concluída até que haja dados a serem lidos, todos os dados serão gravados ou um cliente estiver conectado.

Nota Um valor de FILE_PIPE_QUEUE_OPERATION para CompletionMode pode resultar em espera indefinidamente para que um processo de cliente execute uma ação.
 
Quando CompletionMode estiver definido como FILE_PIPE_COMPLETE_OPERATION, se o pipe estiver sendo conectado, lido ou gravado, a operação será concluída imediatamente.

Para obter informações sobre pipes, consulte Pipes.

Requisitos

   
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores do sistema operacional Windows.
Cabeçalho ntifs.h (include FltKernel.h, Ntifs.h)