Función GetMailslotInfo (winbase.h)

Recupera información sobre el mailslot especificado.

Sintaxis

BOOL GetMailslotInfo(
  [in]            HANDLE  hMailslot,
  [out, optional] LPDWORD lpMaxMessageSize,
  [out, optional] LPDWORD lpNextSize,
  [out, optional] LPDWORD lpMessageCount,
  [out, optional] LPDWORD lpReadTimeout
);

Parámetros

[in] hMailslot

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

[out, optional] lpMaxMessageSize

Tamaño máximo de mensaje, en bytes, permitido para este mailslot. Este valor puede ser mayor o igual que el valor especificado en el parámetro cbMaxMsg de la función CreateMailslot que creó el mailslot. Este parámetro puede ser NULL.

[out, optional] lpNextSize

Tamaño del mensaje siguiente, en bytes. El valor siguiente tiene un significado especial.

Valor	Significado
MAILSLOT_NO_MESSAGE ((DWORD)-1)	No hay ningún mensaje siguiente.

 

Este parámetro puede ser NULL.

[out, optional] lpMessageCount

Número total de mensajes en espera de lectura, cuando la función vuelve. Este parámetro puede ser NULL.

[out, optional] lpReadTimeout

La cantidad de tiempo, en milisegundos, una operación de lectura puede esperar a que se escriba un mensaje en el mailslot antes de que se produzca un tiempo de espera. Este parámetro se rellena cuando la función devuelve. Este parámetro puede ser NULL.

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.

Requisitos

Requisito	Value
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

Funciones mailslot

Información general sobre mailslots

SetMailslotInfo