Função PerfEnumerateCounterSet (perflib.h)

Artigo
03/13/2024

Obtém os identificadores do conjunto de contadores dos conjuntos de contadores registrados no

sistema especificado.

Identificadores de conjunto de contadores são GUIDs (identificadores globalmente exclusivos).

Sintaxe

ULONG PerfEnumerateCounterSet(
  [in, optional]  LPCWSTR szMachine,
  [out, optional] LPGUID  pCounterSetIds,
                  DWORD   cCounterSetIds,
  [out]           LPDWORD pcCounterSetIdsActual
);

Parâmetros

[in, optional] szMachine

O nome do computador para o qual obter os identificadores do conjunto de contadores. Se FOR NULL, a função recuperará os identificadores do conjunto de contadores para o computador local.

[out, optional] pCounterSetIds

Um ponteiro para um buffer que tem espaço suficiente para receber o número de GUIDs especificado pelo parâmetro cCounterSetIds . Pode ser NULL se

cCounterSetIds é 0.

cCounterSetIds

O tamanho do buffer especificado pelo parâmetro pCounterSetIds , medido em GUIDs.

[out] pcCounterSetIdsActual

O tamanho do buffer realmente necessário para obter os identificadores do conjunto de contadores. O significado depende do valor que a função

Retorna.

Valor retornado da função	Significado de pcCounterSetIdsActual
ERROR_SUCCESS	O número de GUIDs que a função armazenou no buffer que pCounterSetIds especificou.
ERROR_NOT_ENOUGH_MEMORY	O tamanho (em GUIDs) do buffer necessário. Ampliar o buffer para o necessário dimensione e chame a função novamente.
Outro	O valor é indefinido e não deve ser usado.

Valor retornado da função

Significado de pcCounterSetIdsActual

ERROR_SUCCESS

O número de

GUIDs que a função armazenou no buffer que pCounterSetIds especificou.

ERROR_NOT_ENOUGH_MEMORY

tamanho (em GUIDs) do buffer necessário. Ampliar o buffer para o necessário

dimensione e chame a função novamente.

Outro

O valor é indefinido e não deve ser usado.

Retornar valor

Código de retorno	Descrição
ERROR_SUCCESS	A função armazenou com êxito todos os identificadores do conjunto de conteúdo no buffer especificado por pCounterSetIds . O valor para o qual pcCounterSetIdsActual aponta indica o número de identificadores de conjunto de contadores realmente armazenados no buffer.
ERROR_NOT_ENOUGH_MEMORY	O buffer que pCounterSetIds especificou não era grande o suficiente para armazenar todos os identificadores de conjunto de contadores para os conjuntos de contadores no sistema especificado. O valor para o qual pcCounterSetIdsActual aponta indica o tamanho do buffer necessário para armazenar todos os identificadores do conjunto de contadores. Ampliar o buffer para o necessário dimensione e chame a função novamente.

Código de retorno

Descrição

ERROR_SUCCESS

A função armazenou com êxito todos os identificadores do conjunto de conteúdo no buffer especificado por pCounterSetIds . O valor para o qual pcCounterSetIdsActual aponta indica o número de identificadores de conjunto de contadores realmente armazenados no buffer.

ERROR_NOT_ENOUGH_MEMORY

O buffer que pCounterSetIds especificou não era grande o suficiente para armazenar todos os identificadores de conjunto de contadores para os conjuntos de contadores no sistema especificado. O valor para o qual pcCounterSetIdsActual aponta indica o tamanho do buffer necessário para armazenar todos os identificadores do conjunto de contadores. Ampliar o buffer para o necessário

dimensione e chame a função novamente.

Para outros tipos de falhas, o valor retornado é um código de erro do sistema.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1607 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	perflib.h
Biblioteca	AdvAPI32.lib
DLL	AdvAPI32.dll

Confira também

PerfEnumerateCounterSetInstances

Compartilhar via