Funzione NetStatisticsGet (lmstats.h)

Articolo
02/28/2024

Recupera le statistiche operative per un servizio. Attualmente sono supportati solo i servizi workstation e server.

Sintassi

NET_API_STATUS NET_API_FUNCTION NetStatisticsGet(
  [in]  LPTSTR ServerName,
  [in]  LPTSTR Service,
  [in]  DWORD  Level,
  [in]  DWORD  Options,
  [out] LPBYTE *Buffer
);

Parametri

[in] ServerName

Puntatore a una stringa che specifica il nome DNS o NetBIOS del server in cui deve essere eseguita la funzione. Se questo parametro è NULL, viene utilizzato il computer locale.

[in] Service

Puntatore a una stringa che specifica il nome del servizio su cui ottenere le statistiche. Sono attualmente consentiti solo i valori SERVICE_SERVER e SERVICE_WORKSTATION .

[in] Level

Specifica il livello di informazioni dei dati. Questo parametro può essere il valore seguente.

Valore	Significato
0	Restituisce statistiche su una workstation o un server. Il parametro bufptr punta a un STAT_WORKSTATION_0 o a una struttura STAT_SERVER_0 .

[in] Options

Questo parametro deve essere zero.

[out] Buffer

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 . Per altre informazioni, vedere Buffer delle funzioni di gestione di rete e lunghezze del buffer delle funzioni di gestione di rete.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema. Per un elenco dei codici di errore, vedere Codici errore di sistema.

Commenti

Per ottenere le statistiche sulle workstation non è necessaria alcuna appartenenza a gruppi speciali. Solo i membri del gruppo locale Administrators o Server Operators possono eseguire correttamente la funzione NetStatisticsGet in un server remoto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	lmstats.h (include Lm.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll