Função NetStatisticsGet (lmstats.h)

Artigo
03/13/2024

Recupera estatísticas operacionais de um serviço. Atualmente, há suporte apenas para a estação de trabalho e os serviços de servidor.

Sintaxe

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

Parâmetros

[in] ServerName

Ponteiro para uma cadeia de caracteres que especifica o nome DNS ou NetBIOS do servidor no qual a função deve ser executada. Se esse parâmetro for NULL, o computador local será usado.

[in] Service

Ponteiro para uma cadeia de caracteres que especifica o nome do serviço sobre o qual obter as estatísticas. Somente os valores SERVICE_SERVER e SERVICE_WORKSTATION são permitidos no momento.

[in] Level

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

Valor	Significado
0	Retornar estatísticas sobre uma estação de trabalho ou um servidor. O parâmetro bufptr aponta para um STAT_WORKSTATION_0 ou uma estrutura STAT_SERVER_0 .

[in] Options

Esse parâmetro deve ser zero.

[out] Buffer

Ponteiro para o buffer que recebe os dados. O formato desses dados depende do valor do parâmetro de nível . 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.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NERR_Success.

Se a função falhar, o valor retornado será um código de erro do sistema. Para obter uma lista de códigos de erro, consulte Códigos de erro do sistema.

Comentários

Nenhuma associação de grupo especial é necessária para obter estatísticas de estação de trabalho. Somente membros do grupo local Administradores ou Operadores de Servidor podem executar com êxito a função NetStatisticsGet em um servidor remoto.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	lmstats.h (inclua Lm.h)
Biblioteca	Netapi32.lib
DLL	Netapi32.dll