Compartilhar via


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

Confira também

CreateMailslot

GetMailslotInfo

Funções do Maillot

Visão geral do Maillots