Função NetMessageNameGetInfo (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 NetMessageNameGetInfo recupera informações sobre um alias de mensagem específico 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 NetMessageNameGetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR msgname,
  [in]  DWORD   level,
  [out] LPBYTE  *bufptr
);

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 retornar informações.

[in] level

Especifica o nível de informações dos dados. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
0	Retornar o alias da mensagem. O parâmetro bufptr aponta para uma estrutura MSG_INFO_0 .
1	Retornar o alias da mensagem. O parâmetro bufptr aponta para uma estrutura MSG_INFO_1 . Esse nível existe apenas para compatibilidade. Não há suporte para o encaminhamento de mensagens.

[out] bufptr

Ponteiro para o buffer que recebe os dados. O formato desses dados depende do valor do parâmetro level . Esse buffer é alocado pelo sistema e deve ser liberado usando a função NetApiBufferFree . Para obter mais informações, consulte Buffers de função de gerenciamento de rede e Comprimentos de buffer de função de gerenciamento de rede.

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_LEVEL	O valor especificado para o parâmetro level é inválido.
ERROR_INVALID_PARAMETER	Um parâmetro está incorreto.
ERROR_NOT_ENOUGH_MEMORY	Memória insuficiente disponível.
ERROR_NOT_SUPPORTED	Não há suporte para essa solicitação. Esse erro é retornado no Windows Vista e posterior.
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 NetMessageNameGetInfo em um servidor remoto.

Para listar todos os aliases de mensagem em uma tabela de nomes de mensagem, você pode chamar a função NetMessageNameEnum .

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