Funzione NetMessageNameGetInfo (lmmsg.h)

Articolo
08/24/2023

[Questa funzione non è supportata come in Windows Vista perché il servizio messenger non è supportato.]

La funzione NetMessageNameGetInfo recupera informazioni su un alias di messaggio specifico nella tabella dei nomi del messaggio. La funzione richiede l'avvio del servizio messenger.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetMessageNameGetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR msgname,
  [in]  DWORD   level,
  [out] LPBYTE  *bufptr
);

Parametri

[in] servername

Puntatore a una stringa costante che specifica il nome DNS o NetBIOS del server remoto in cui eseguire la funzione. Se questo parametro è NULL, viene usato il computer locale.

[in] msgname

Puntatore a una stringa costante che specifica l'alias del messaggio per cui restituire informazioni.

[in] level

Specifica il livello di informazioni dei dati. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
0	Restituisce l'alias del messaggio. Il parametro bufptr punta a una struttura MSG_INFO_0 .
1	Restituisce l'alias del messaggio. Il parametro bufptr punta a una struttura MSG_INFO_1 . Questo livello esiste solo per la compatibilità. L'inoltro dei messaggi non è supportato.

[out] bufptr

Puntatore al buffer che riceve i dati. Il formato di questi dati dipende dal valore del parametro di livello . Questo buffer viene allocato dal sistema e deve essere liberato usando la funzione NetApiBufferFree . Per altre informazioni, vedere Buffer delle funzioni di gestione della rete e lunghezze del buffer delle funzioni di gestione della rete.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NERR_Success.

Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.

Codice restituito	Descrizione
ERROR_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato per completare l'operazione.
ERROR_INVALID_LEVEL	Il valore specificato per il parametro di livello non è valido.
ERROR_INVALID_PARAMETER	Un parametro non è corretto.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente disponibile.
ERROR_NOT_SUPPORTED	Questa richiesta non è supportata. Questo errore viene restituito in Windows Vista e versioni successive.
NERR_NotLocalName	L'alias del messaggio non è nel computer locale.

Commenti

Solo i membri del gruppo locale Administrators possono eseguire correttamente la funzione NetMessageNameGetInfo in un server remoto.

Per elencare tutti gli alias di messaggio in una tabella dei nomi del messaggio, è possibile chiamare la funzione NetMessageNameEnum .

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	lmmsg.h (include Lm.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll