Função PerfQueryCounterSetRegistrationInfo (perflib.h)

Obtém informações sobre um conjunto de contadores no sistema especificado.

Sintaxe

ULONG PerfQueryCounterSetRegistrationInfo(
  [in, optional]  LPCWSTR         szMachine,
  [in]            LPCGUID         pCounterSetId,
                  PerfRegInfoType requestCode,
                  DWORD           requestLangId,
  [out, optional] LPBYTE          pbRegInfo,
                  DWORD           cbRegInfo,
  [out]           LPDWORD         pcbRegInfoActual
);

Parâmetros

[in, optional] szMachine

O nome do computador para o qual obter as informações sobre o conjunto de contadores especificado pelo parâmetro pCounterSet . Se FOR NULL, a função recuperará informações sobre o conjunto de contadores especificado para o computador local.

[in] pCounterSetId

O identificador do conjunto de contadores do conjunto de contadores para o qual você deseja obter informações.

requestCode

O tipo de informação que você deseja obter sobre o conjunto de contadores. Consulte PerfRegInfoType para obter uma lista de valores possíveis.

requestLangId

O identificador de localidade preferencial para as cadeias de caracteres que contêm as informações solicitadas se requestCode for PERF_REG_COUNTERSET_NAME_STRING,

PERF_REG_COUNTERSET_HELP_STRING, PERF_REG_COUNTER_NAME_STRINGS ou

PERF_REG_COUNTER_HELP_STRINGS.

O identificador do contador para o qual você deseja dados, se requestCode for PERF_REG_COUNTER_STRUCT.

Defina como 0 para todos os outros valores de requestCode.

[out, optional] pbRegInfo

Ponteiro para um buffer grande o suficiente para receber a quantidade de dados especificada pelo parâmetro cbRegInfo , em bytes. Talvez

NULL se cbRegInfo for 0.

cbRegInfo

O tamanho do buffer especificado pelo parâmetro pbRegInfo , em bytes.

[out] pcbRegInfoActual

O tamanho do buffer realmente necessário para obter as informações sobre o conjunto de contadores. O significado depende do valor que a função

Retorna.

Valor retornado da função	Significado de pcbRegInfoActual
ERROR_SUCCESS	O número de bytes de informações sobre o conjunto de contadores especificado que a função armazenou no buffer que pbRegInfo especificou.
ERROR_NOT_ENOUGH_MEMORY	O tamanho do buffer necessário para armazenar as informações sobre o contador definido no computador especificado, em bytes. 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

Código de retorno	Descrição
ERROR_SUCCESS	A função armazenou com êxito todas as informações sobre o contador definido no buffer especificado por pbRegInfo . O valor para o qual pcbRegInfoActual aponta indica a quantidade de informações realmente armazenadas no buffer, em bytes.
ERROR_NOT_ENOUGH_MEMORY	O buffer especificado por pbRegInfo não era grande o suficiente para armazenar todas as informações sobre o conjunto de contadores. O valor para o qual pcbRegInfoActual aponta indica o tamanho do buffer necessário para armazenar todas as informações. 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.

Comentários

Consulte PerfRegInfoType para obter os tipos de dados que você pode solicitar e

os formatos dos dados fornecidos para cada tipo de solicitação.

Requisitos

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