Voltar à lista
Windows Win32IPCkernel32.dll

CreateMailslotW

Cria um mailslot, um mecanismo de mensagens unidirecional e sem confirmação, utilizável inclusive via broadcast na rede.

Descrição

Sem equivalente direto no Linux; historicamente usado para descoberta de serviços e mensagens simples de notificação em redes locais antigas, hoje em grande parte substituído por sockets UDP/named pipes.

Header: winbase.hDLL: kernel32.dll

Assinatura

HANDLE CreateMailslotW(
    LPCWSTR lpName,
    DWORD nMaxMessageSize,
    DWORD lReadTimeout,
    LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

Parâmetros

ParâmetroTipoDescrição
lpNameLPCWSTRNome do mailslot, no formato \\.\mailslot\nome.
nMaxMessageSizeDWORDTamanho máximo de mensagem, ou 0 para ilimitado.
lReadTimeoutDWORDTimeout de leitura em milissegundos, ou MAILSLOT_WAIT_FOREVER.
lpSecurityAttributesLPSECURITY_ATTRIBUTESAtributos de segurança, ou NULL.

Valor de retorno

Um handle para o mailslot em sucesso; INVALID_HANDLE_VALUE em erro (consulte GetLastError).

Códigos de erro (GetLastError)

ERROR_ALREADY_EXISTS(183)
Não é possível criar um arquivo já existente.
ERROR_INVALID_PARAMETER(87)
Parâmetro incorreto.

Relacionadas

Mesma categoria

CallNamedPipeWConnectNamedPipeCreateNamedPipeWCreatePipeDisconnectNamedPipeGetMailslotInfoPeekNamedPipePostThreadMessageW