Função NetMessageBufferSend (lmmsg.h)

Artigo
08/24/2023

[Não há suporte para essa função a partir do Windows Vista porque não há suporte para o serviço de mensagens.]

A função NetMessageBufferSend envia um buffer de informações para um alias de mensagem registrado.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetMessageBufferSend(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname,
  [in] LPCWSTR fromname,
  [in] LPBYTE  buf,
  [in] DWORD   buflen
);

Parâmetros

[in] servername

Ponteiro para uma cadeia de caracteres constante que especifica o nome DNS ou NetBIOS do servidor remoto no qual a função deve ser executada. Se esse parâmetro for NULL, o computador local será usado.

[in] msgname

Ponteiro para uma cadeia de caracteres constante que especifica o alias da mensagem para o qual o buffer de mensagem deve ser enviado.

[in] fromname

Ponteiro para uma cadeia de caracteres constante especificando de quem é a mensagem. Se esse parâmetro for NULL, a mensagem será enviada do nome do computador local.

[in] buf

Ponteiro para um buffer que contém o texto da mensagem. Para obter mais informações, consulte Buffers de função de gerenciamento de rede.

[in] buflen

Especifica um valor que contém o comprimento, em bytes, do texto da mensagem apontado pelo parâmetro buf .

Valor retornado

Se a função for bem-sucedida, o valor retornado será NERR_Success.

Se a função falhar, o valor retornado poderá ser um dos códigos de erro a seguir.

Código de retorno	Descrição
ERROR_ACCESS_DENIED	O chamador não tem o acesso apropriado para concluir a operação.
ERROR_INVALID_PARAMETER	Um parâmetro está incorreto.
ERROR_NOT_SUPPORTED	Não há suporte para essa solicitação. Esse erro é retornado no Windows Vista e posterior.
NERR_NameNotFound	Não foi possível encontrar o nome de usuário.
NERR_NetworkError	Ocorreu uma falha geral no hardware de rede.

Comentários

Se você chamar essa função em um controlador de domínio que está executando o Active Directory, o acesso será permitido ou negado com base na ACL (lista de controle de acesso) do objeto protegível. A ACL padrão permite que somente administradores de domínio e operadores de conta chamem essa função. Em um servidor membro ou estação de trabalho, somente administradores e operadores de servidor podem chamar essa função. Para obter mais informações, consulte Requisitos de segurança para as funções de gerenciamento de rede. Para obter mais informações sobre ACLs e ACEs, consulte Controle de Acesso Model.

Requisitos


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	lmmsg.h (inclua Lm.h)
Biblioteca	Netapi32.lib
DLL	Netapi32.dll