Condividi tramite

struttura FILE_PIPE_INFORMATION (ntifs.h)

  • Articolo

La struttura FILE_PIPE_INFORMATION contiene informazioni su una named pipe non specifica per l'estremità locale o remota della pipe.

Sintassi

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

Membri

ReadMode

Uno dei valori seguenti.

Valore Significato
FILE_PIPE_BYTE_STREAM_MODE (0x00000000) I dati sono letti dalla pipe come flusso di byte.
FILE_PIPE_MESSAGE_MODE (0x00000001) I dati vengono letti dalla pipe come flusso di messaggi.

CompletionMode

Uno dei valori seguenti.

Valore Significato
FILE_PIPE_QUEUE_OPERATION (0x00000000) Modalità di blocco
FILE_PIPE_COMPLETE_OPERATION (0x00000001) Modalità non bloccaggio

Osservazioni

Se ReadMode è impostato su FILE_PIPE_BYTE_STREAM_MODE, qualsiasi tentativo di modifica deve non riuscire con un codice di errore STATUS_INVALID_PARAMETER.

Quando CompletionMode è impostato su FILE_PIPE_QUEUE_OPERATION, se la pipe è connessa, letta o scritta da, l'operazione non viene completata fino a quando non sono presenti dati da leggere, tutti i dati vengono scritti o un client è connesso.

Nota Un valore di FILE_PIPE_QUEUE_OPERATION per CompletionMode può comportare l'attesa illimitata di un processo client per eseguire un'azione.
 
Quando CompletionMode è impostato su FILE_PIPE_COMPLETE_OPERATION, se la pipe è connessa, letta o scritta da, l'operazione viene completata immediatamente.

Per informazioni sulle pipe, vedere Pipe.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000
intestazione ntifs.h (include FltKernel.h, Ntifs.h)