Share via

Função NetMessageNameDel (lmmsg.h)

  • Artigo

[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 NetMessageNameDel exclui 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 NetMessageNameDel(
  [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 excluído. A cadeia de caracteres não pode ter mais de 15 caracteres.

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_DelComputerName
 Um alias de mensagem que também é um nome de computador não pode ser excluído.
NERR_IncompleteDel
 O alias da mensagem não foi excluído com êxito de todas as redes.
NERR_NameInUse
 O alias da mensagem está em uso no momento. Tente novamente depois.
NERR_NotLocalName
 O alias da mensagem não está no computador local.

Comentários

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

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

Confira também

Funções de mensagem

NetMessageNameAdd

Funções de gerenciamento de rede

Visão geral do gerenciamento de rede