Función SetMailslotInfo (winbase.h)

Establece el valor de tiempo de espera utilizado por el mailslot especificado para una operación de lectura.

Sintaxis

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

Parámetros

[in] hMailslot

Identificador de un mailslot. La función CreateMailslot debe crear este identificador.

[in] lReadTimeout

El tiempo que una operación de lectura puede esperar a que se escriba un mensaje en el mailslot antes de que se agote el tiempo de espera, en milisegundos. Los valores siguientes tienen significados especiales.

Valor	Significado
0	Devuelve inmediatamente si no hay ningún mensaje presente. (El sistema no trata una devolución inmediata como un error).
MAILSLOT_WAIT_FOREVER ((DWORD)-1)	Espera para siempre un mensaje.

 

Este valor de tiempo de espera se aplica a todas las operaciones de lectura posteriores y a todos los identificadores de mailslot heredados.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

El valor de tiempo de espera inicial usado por un mailslot para una operación de lectura suele establecerse mediante CreateMailslot cuando se crea el mailslot.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluye Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

CreateMailslot

GetMailslotInfo

Funciones mailslot

Información general sobre mailslots