PerfQueryCounterSetRegistrationInfo 함수(perflib.h)

지정된 시스템의 카운터 집합에 대한 정보를 가져옵니다.

구문

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

매개 변수

[in, optional] szMachine

pCounterSet 매개 변수가 지정하는 카운터 집합에 대한 정보를 가져올 컴퓨터의 이름입니다. NULL인 경우 함수는 로컬 머신에 대해 지정된 카운터 집합에 대한 정보를 검색합니다.

[in] pCounterSetId

정보를 가져올 카운터 집합의 카운터 집합 식별자입니다.

requestCode

카운터 집합에 대해 가져올 정보 유형입니다. 가능한 값 목록은 PerfRegInfoType 을 참조하세요.

requestLangId

requestCode가 PERF_REG_COUNTERSET_NAME_STRING 경우 요청된 정보를 포함하는 문자열에 대한 기본 설정 로캘 식별자입니다.

PERF_REG_COUNTERSET_HELP_STRING, PERF_REG_COUNTER_NAME_STRINGS 또는

PERF_REG_COUNTER_HELP_STRINGS.

requestCode가 PERF_REG_COUNTER_STRUCT 경우 데이터를 원하는 카운터의 카운터 식별자입니다.

requestCode의 다른 모든 값에 대해 0으로 설정합니다.

[out, optional] pbRegInfo

cbRegInfo 매개 변수가 지정하는 데이터의 양을 바이트 단위로 받을 수 있을 만큼 큰 버퍼에 대한 포인터입니다. 아마

cbRegInfo가 0이면 NULL입니다.

cbRegInfo

pbRegInfo 매개 변수가 지정하는 버퍼의 크기(바이트)입니다.

[out] pcbRegInfoActual

카운터 집합에 대한 정보를 가져오는 데 실제로 필요한 버퍼의 크기입니다. 의미는 함수의 값에 따라 달라집니다.

반환.

함수 반환 값	pcbRegInfoActual의 의미
ERROR_SUCCESS	의 수 pbRegInfo가 지정한 버퍼에 저장된 함수가 지정한 카운터 집합에 대한 정보의 바이트입니다.
ERROR_NOT_ENOUGH_MEMORY	The 지정된 머신에 설정된 카운터에 대한 정보를 바이트 단위로 저장하는 데 필요한 버퍼의 크기입니다. 버퍼를 필수로 확대 크기를 조정하고 함수를 다시 호출합니다.
기타	값이 정의되어 있지 않으므로 사용하면 안 됩니다.

반환 값

반환 코드	설명
ERROR_SUCCESS	함수는 pbRegInfo 가 지정한 버퍼에 설정된 카운터에 대한 모든 정보를 성공적으로 저장했습니다. pcbRegInfoActual이 가리키는 값은 버퍼에 실제로 저장된 정보의 양을 바이트 단위로 나타냅니다.
ERROR_NOT_ENOUGH_MEMORY	pbRegInfo가 지정한 버퍼가 카운터 집합에 대한 모든 정보를 저장할 만큼 크지 않았습니다. pcbRegInfoActual이 가리키는 값은 모든 정보를 저장하는 데 필요한 버퍼의 크기를 나타냅니다. 버퍼를 필수로 확대 크기를 조정하고 함수를 다시 호출합니다.

 

다른 유형의 오류의 경우 반환 값은 시스템 오류 코드입니다.

설명

요청할 수 있는 데이터 형식은 PerfRegInfoType 을 참조하세요.

각 요청 유형에 대해 제공된 데이터의 형식입니다.

요구 사항

지원되는 최소 클라이언트	Windows 10 버전 1607 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	perflib.h
라이브러리	AdvAPI32.lib
DLL	AdvAPI32.dll