Compartilhar via


Função NetMessageNameAdd (lmmsg.h)

[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 NetMessageNameAdd registra um alias de mensagem na tabela de nomes da mensagem. A função requer que o serviço de mensagens seja iniciado.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetMessageNameAdd(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname
);

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 a ser adicionado. A cadeia de caracteres não pode ter mais de 15 caracteres.

Retornar valor

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_AlreadyExists
O alias da mensagem já existe neste computador. Para obter mais informações, consulte a seção Comentários a seguir.
NERR_DuplicateName
O nome especificado já está em uso como um alias de mensagem na rede.
NERR_NetworkError
Ocorreu uma falha geral no hardware de rede.
NERR_TooManyNames
O número máximo de aliases de mensagem foi excedido.

Comentários

Somente os membros do grupo local Administradores podem executar com êxito a função NetMessageNameAdd em um servidor remoto.

O sinalizador de ação de encaminhamento não é mais um parâmetro para o LAN Manager 2. XFunção NetMessageNameAdd porque não há mais suporte para o encaminhamento de mensagens. Se a função NetMessageNameAdd detectar que existe uma versão encaminhada do msgname na rede, a função falhará com o erro NERR_Already_Exists.

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

Confira também

Funções de mensagem

NetMessageNameDel

Funções de gerenciamento de rede

Visão geral do gerenciamento de rede