Função GetMailslotInfo (winbase.h)
Recupera informações sobre o maillot especificado.
Sintaxe
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
Um identificador para um maillot. A função CreateMailslot deve criar esse identificador.
[out, optional] lpMaxMessageSize
O tamanho máximo da mensagem, em bytes, permitido para este emaillot. Esse valor pode ser maior ou igual ao valor especificado no parâmetro cbMaxMsg da função CreateMailslot que criou o maillot. Este parâmetro pode ser NULL.
[out, optional] lpNextSize
O tamanho da próxima mensagem, em bytes. O valor a seguir tem um significado especial.
| Valor | Significado |
|---|---|
|
Não há nenhuma próxima mensagem. |
Este parâmetro pode ser NULL.
[out, optional] lpMessageCount
O número total de mensagens aguardando para serem lidas, quando a função retorna. Este parâmetro pode ser NULL.
[out, optional] lpReadTimeout
A quantidade de tempo, em milissegundos, uma operação de leitura pode esperar que uma mensagem seja gravada no maillot antes que ocorra um tempo limite. Esse parâmetro é preenchido quando a função retorna. Este parâmetro pode ser NULL.
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.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |