PerfEnumerateCounterSetInstances 함수(perflib.h)
에 설정된 카운터의 활성 인스턴스 이름 및 식별자를 가져옵니다.
지정된 시스템입니다.
구문
ULONG PerfEnumerateCounterSetInstances(
[in, optional] LPCWSTR szMachine,
[in] LPCGUID pCounterSetId,
[out, optional] PPERF_INSTANCE_HEADER pInstances,
DWORD cbInstances,
[out] LPDWORD pcbInstancesActual
);
매개 변수
[in, optional] szMachine
pCounterSet 매개 변수가 지정하는 카운터 집합의 활성 인스턴스에 대한 정보를 가져올 컴퓨터의 이름입니다. NULL인 경우 함수는 로컬 컴퓨터에 대해 지정된 카운터 집합의 활성 인스턴스에 대한 정보를 검색합니다.
[in] pCounterSetId
활성 인스턴스에 대한 정보를 가져올 카운터 집합의 카운터 집합 식별자입니다.
[out, optional] pInstances
cbInstances 매개 변수가 지정하는 데이터의 양을 받을 수 있을 만큼 큰 버퍼에 대한 포인터입니다. 아마
cbInstances가 0이면 NULL입니다.
cbInstances
pInstances 매개 변수가 지정하는 버퍼의 크기(바이트)입니다.
[out] pcbInstancesActual
활성 인스턴스에 대한 정보를 가져오는 데 실제로 필요한 버퍼의 크기입니다. 의미는 함수의 값에 따라 달라집니다.
반환.
| 함수 반환 값 | pcbInstancesActual의 의미 |
|---|---|
| ERROR_SUCCESS | 의 수 pInstance가 지정한 버퍼에 저장된 함수가 지정한 카운터 집합의 활성 인스턴스에 대한 정보 바이트입니다. |
| ERROR_NOT_ENOUGH_MEMORY | The 지정된 컴퓨터에 설정된 카운터의 활성 인스턴스에 대한 정보를 바이트 단위로 저장하는 데 필요한 버퍼의 크기입니다. 버퍼를 필수로 확대 크기를 조정하고 함수를 다시 호출합니다. |
| 기타 | 값이 정의되지 않았으며 사용하면 안 됩니다. |
반환 값
| 반환 코드 | 설명 |
|---|---|
|
함수는 pInstance 가 지정한 버퍼에 설정된 카운터의 활성 인스턴스에 대한 모든 정보를 성공적으로 저장했습니다. pcbInstancesActual이 가리키는 값은 실제로 버퍼에 저장된 정보의 양을 바이트 단위로 나타냅니다. |
|
pInstance가 지정한 버퍼가 카운터 집합의 활성 인스턴스에 대한 모든 정보를 저장할 만큼 크지 않았습니다. pcbInstancesActual이 가리키는 값은 모든 정보를 저장하는 데 필요한 버퍼의 크기를 나타냅니다. 버퍼를 필수로 확대 크기를 조정하고 함수를 다시 호출합니다. |
다른 유형의 오류의 경우 반환 값은 시스템 오류 코드입니다.
설명
지정된 카운터 집합의 활성 인스턴스에 대한 정보는 pInstances 가 PERF_INSTANCE_HEADER 블록 시퀀스로 지정하는 버퍼에 기록됩니다. 의 크기(바이트)입니다.
블록 시퀀스는 pcbInstancesActual에 기록됩니다. 각 PERF_INSTANCE_HEADER 블록은
바로 뒤에 null 로 종료된 UTF-16LE이 있는 PERF_INSTANCE_HEADER 구조체
instance 이름, 뒤에 안쪽 여백이 표시되어 의 크기가
PERF_INSTANCE_HEADER 블록은 8바이트의 배수입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 버전 1607 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | perflib.h |
| 라이브러리 | AdvAPI32.lib |
| DLL | AdvAPI32.dll |