estrutura FILE_PIPE_INFORMATION (ntifs.h)

  • Artigo

A estrutura FILE_PIPE_INFORMATION contém informações sobre um pipe nomeado que não é específico para o local ou a 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 sem 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 é 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 para leitura, todos os dados sejam gravados ou um cliente esteja 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 for 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

Requisito Valor
Cliente mínimo com suporte Windows 2000
Cabeçalho ntifs.h (inclua FltKernel.h, Ntifs.h)