다음을 통해 공유

PerfEnumerateCounterSet 함수(perflib.h)

  • 아티클

에 등록된 카운터 집합의 카운터 집합 식별자를 가져옵니다.

지정된 시스템입니다.

카운터 집합 식별자는 GUID(Globally Unique Identifier)입니다.

구문

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

매개 변수

[in, optional] szMachine

카운터 집합 식별자를 가져올 컴퓨터의 이름입니다. NULL인 경우 함수는 로컬 머신에 대한 카운터 집합 식별자를 검색합니다.

[out, optional] pCounterSetIds

cCounterSetIds 매개 변수가 지정하는 GUID 수를 수신하기에 충분한 공간이 있는 버퍼에 대한 포인터입니다. 이면 NULL일 수 있습니다.

cCounterSetIds 는 0입니다.

cCounterSetIds

pCounterSetIds 매개 변수가 지정하는 버퍼의 크기로 GUID로 측정됩니다.

[out] pcCounterSetIdsActual

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

반환.

함수 반환 값 pcCounterSetIdsActual의 의미
ERROR_SUCCESS 의 수

pCounterSetIds가 지정한 버퍼에 저장된 함수의 GUID입니다.
ERROR_NOT_ENOUGH_MEMORY The

필요한 버퍼의 크기(GUID)입니다. 버퍼를 필수로 확대

크기를 조정하고 함수를 다시 호출합니다.
기타 값이 정의되어 있지 않으므로 사용하면 안 됩니다.

반환 값

반환 코드 설명
ERROR_SUCCESS
 함수는 pCounterSetIds 가 지정한 버퍼에 모든 콘텐츠 집합 식별자를 성공적으로 저장했습니다. pcCounterSetIdsActual이 가리키는 값은 버퍼에 실제로 저장된 카운터 집합 식별자 수를 나타냅니다.
ERROR_NOT_ENOUGH_MEMORY
 pCounterSetIds가 지정한 버퍼가 지정된 시스템의 카운터 집합에 대한 모든 카운터 집합 식별자를 저장할 만큼 크지 않았습니다. pcCounterSetIdsActual이 가리키는 값은 모든 카운터 집합 식별자를 저장하는 데 필요한 버퍼의 크기를 나타냅니다. 버퍼를 필수로 확대

크기를 조정하고 함수를 다시 호출합니다.
 

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

요구 사항

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

추가 정보

PerfEnumerateCounterSetInstances