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 |
|---|---|
|
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. |
|
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 |