Função SetMailslotInfo (winbase.h)

Define o valor de tempo limite usado pelo maillot especificado para uma operação de leitura.

Sintaxe

BOOL SetMailslotInfo(
  [in] HANDLE hMailslot,
  [in] DWORD  lReadTimeout
);

Parâmetros

[in] hMailslot

Um identificador para um maillot. A função CreateMailslot deve criar esse identificador.

[in] lReadTimeout

O tempo em que uma operação de leitura pode aguardar a gravação de uma mensagem no emaillot antes que ocorra um tempo limite, em milissegundos. Os valores a seguir têm significados especiais.

Valor	Significado
0	Retorna imediatamente se nenhuma mensagem estiver presente. (O sistema não trata um retorno imediato como um erro.)
MAILSLOT_WAIT_FOREVER ((DWORD)-1)	Espera para sempre por uma mensagem.

Esse valor de tempo limite se aplica a todas as operações de leitura subsequentes e a todos os identificadores de maillot herdados.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

O valor de tempo limite inicial usado por um emaillot para uma operação de leitura normalmente é definido por CreateMailslot quando o maillot é criado.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll