Compartir a través de


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