Funzione NetMessageNameEnum (lmmsg.h)
[Questa funzione non è supportata a partire da Windows Vista perché il servizio messenger non è supportato.]
La funzione NetMessageNameEnum elenca gli alias di messaggio che ricevono messaggi in un computer specificato. La funzione richiede l'avvio del servizio messenger.
Sintassi
NET_API_STATUS NET_API_FUNCTION NetMessageNameEnum(
[in] LPCWSTR servername,
[in] DWORD level,
[out] LPBYTE *bufptr,
[in] DWORD prefmaxlen,
[out] LPDWORD entriesread,
[out] LPDWORD totalentries,
[in, out] LPDWORD resume_handle
);
Parametri
[in] servername
Puntatore a una stringa costante che specifica il nome DNS o NetBIOS del server remoto in cui deve essere eseguita la funzione. Se questo parametro è NULL, viene utilizzato il computer locale.
[in] level
Specifica il livello di informazioni dei dati. Questo parametro può avere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Restituire gli alias dei messaggi. Il parametro bufptr punta a una matrice di strutture MSG_INFO_0 . |
|
Restituire gli alias dei messaggi. Il parametro bufptr punta a una matrice di strutture 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 level . Questo buffer viene allocato dal sistema e deve essere liberato usando la funzione NetApiBufferFree . Si noti che è necessario liberare il buffer anche se la funzione ha esito negativo con ERROR_MORE_DATA.
[in] prefmaxlen
Specifica la lunghezza massima preferita dei dati restituiti, in byte. Se si specifica MAX_PREFERRED_LENGTH, la funzione alloca la quantità di memoria necessaria per i dati. Se si specifica un altro valore in questo parametro, è possibile limitare il numero di byte restituiti dalla funzione. Se le dimensioni del buffer non sono sufficienti per contenere tutte le voci, la funzione restituisce ERROR_MORE_DATA. Per altre informazioni, vedere Buffer delle funzioni di gestione di rete e lunghezze del buffer delle funzioni di gestione di rete.
[out] entriesread
Puntatore a un valore che riceve il conteggio degli elementi effettivamente enumerati.
[out] totalentries
Puntatore a un valore che riceve il numero totale di voci che potrebbero essere state enumerate dalla posizione di ripresa corrente. Si noti che le applicazioni devono considerare questo valore solo come hint.
[in, out] resume_handle
Puntatore a un valore che contiene un handle di ripresa usato per continuare una ricerca di alias di messaggio esistente. L'handle deve essere zero nella prima chiamata e lasciare invariato per le chiamate successive. Se resume_handle è NULL, non viene archiviato alcun handle di ripresa.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene NERR_Success.
Se la funzione ha esito negativo, il valore restituito può essere uno dei codici di errore seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Il chiamante non dispone dell'accesso appropriato per completare l'operazione. |
|
Il valore specificato per il parametro level non è valido. |
|
Un parametro non è corretto. |
|
Sono disponibili altre voci. Specificare un buffer sufficientemente grande per ricevere tutte le voci. |
|
Memoria insufficiente disponibile. |
|
Questa richiesta non è supportata. Questo errore viene restituito in Windows Vista e versioni successive. |
|
Il buffer fornito è troppo piccolo. |
Commenti
Solo i membri del gruppo locale Administrators possono eseguire correttamente la funzione NetMessageNameEnum in un server remoto.
Per recuperare informazioni su un alias di messaggio specifico nella tabella dei nomi del messaggio, è possibile chiamare la funzione NetMessageNameGetInfo .
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 |