Função NetMessageNameDel (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 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 |
|---|---|
|
O chamador não tem o acesso apropriado para concluir a operação. |
|
Um parâmetro está incorreto. |
|
Não há suporte para essa solicitação. Esse erro é retornado no Windows Vista e posterior. |
|
Um alias de mensagem que também é um nome de computador não pode ser excluído. |
|
O alias da mensagem não foi excluído com êxito de todas as redes. |
|
O alias da mensagem está em uso no momento. Tente novamente depois. |
|
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 |