PerfQueryCounterSetRegistrationInfo function

Gets information about a counter set on the specified system.

Syntax


ULONG WINAPI PerfQueryCounterSetRegistrationInfo(
  _In_opt_  LPCWSTR         szMachine,
  _In_      LPCGUID         pCounterSetId,
            PerfRegInfoType requestCode,
            DWORD           requestLangId,
  _Out_opt_ LPBYTE          pbRegInfo,
            DWORD           cbRegInfo,
  _Out_     LPDWORD         pcbRegInfoActual  

);

Parameters

szMachine [in, optional]

The name of the machine for which to get the information about the counter set that the pCounterSet parameter specifies. If NULL, the function retrieves information about the specified counter set for the local machine.

pCounterSetId [in]

The counter set identifier of the counter set for which you want to get information.

requestCode

The type of information that you want to get about the counter set. See PerfRegInfoType for a list of possible values.

requestLangId

The preferred locale identifier for the strings that contain the requested information if requestCode is PERF_REG_COUNTERSET_NAME_STRING, PERF_REG_COUNTERSET_HELP_STRING, PERF_REG_COUNTER_NAME_STRINGS, or PERF_REG_COUNTER_HELP_STRINGS.

The counter identifier of the counter for which you want data, if requestCode is PERF_REG_COUNTER_STRUCT.

Set to 0 for all other values of requestCode.

pbRegInfo [out, optional]

Pointer to a buffer that is large enough to receive the amount of data that the cbRegInfo parameter specifies, in bytes. May be NULL if cbRegInfo is 0.

cbRegInfo

The size of the buffer that the pbRegInfo parameter specifies, in bytes.

pcbRegInfoActual [out]

The size of the buffer actually required to get the information about the counter set. The meaning depends on the value that the function returns.

Function Return ValueMeaning of pcbRegInfoActual
ERROR_SUCCESSThe number of bytes of information about the specified counter set that the function stored in the buffer that pbRegInfo specified.
ERROR_NOT_ENOUGH_MEMORYThe size of the buffer required to store the information about the counter set on the specified machine, in bytes. Enlarge the buffer to the required size and call the function again.
OtherThe value is undefined and should not be used.

 

Return value

Return codeDescription
ERROR_SUCCESS

The function successfully stored all of the information about the counter set in the buffer that pbRegInfo specified. The value that pcbRegInfoActual points to indicates amount of information actually stored in the buffer, in bytes.

ERROR_NOT_ENOUGH_MEMORY

The buffer that pbRegInfo specified was not large enough to store all of the information about the counter set. The value that pcbRegInfoActual points to indicates the size of the buffer required to store all of the information. Enlarge the buffer to the required size and call the function again.

 

For other types of failures, the return value is a system error code.

Remarks

See PerfRegInfoType for the types of data that you can request and the formats of the data provided for each type of request.

Requirements

Minimum supported client

Windows 10, version 1607 [desktop apps only]

Minimum supported server

Windows Server 2016 [desktop apps only]

Header

Perflib.h

Library

AdvAPI32.lib

DLL

AdvAPI32.dll

 

 

Show: