Skip to main content
지정된 대상 엔드포인트에 대해 하나 이상의 통계 카운터 값을 가져옵니다.

Syntax

Parameters

targetEndpointCount   uint32_t targetEndpoints 배열의 대상 엔드포인트 수입니다. 이 로컬 엔드포인트를 포함하여 현재 네트워크에 있는 모든 엔드포인트의 통계를 검색하려면 0일 수 있습니다. targetEndpoints   PartyEndpointArray
크기가 targetEndpointCount인 입력 배열
통계를 검색해야 하는 대상 PartyEndpoint 객체 포인터로 구성된 targetEndpointCount 항목 배열입니다. targetEndpointCount가 0인 경우 이 항목은 무시됩니다. statisticCount   uint32_t 입력 statisticTypes 배열의 통계 수이자 출력 statisticValues 배열에 쓸 통계 수입니다. 최소 1이어야 합니다. statisticTypes   PartyEndpointStatistic*
크기가 statisticCount인 입력 배열
검색할 고유한 PartyEndpointStatistic 유형으로 구성된 statisticCount 항목 입력 배열입니다. statisticValues   uint64_t*
크기가 statisticCount인 출력 배열
통계 값을 쓸 statisticCount 항목 출력 배열입니다. 각 통계 값은 요청된 PartyEndpointStatistic이 statisticTypes 입력 배열에 나타나는 동일한 항목 인덱스에 기록됩니다.

Return value

PartyError 엔드포인트 통계 검색이 성공한 경우 c_partyErrorSuccess, 그렇지 않으면 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형식은 PartyManager::GetErrorMessage()를 통해 검색할 수 있습니다.

Remarks

이 메서드는 이 로컬 엔드포인트와 대상 엔드포인트 사이에 기록된 성능 카운터, 큐 길이, 기록된 사용 메트릭 또는 기타 통계 정보를 검색하는 데 사용됩니다.

또는 여러 대상 엔드포인트를 제공하거나, 이 로컬 엔드포인트를 포함하여 현재 네트워크에 있는 모든 대상 엔드포인트에 대한 통계를 검색하기 위해 항목이 0인 배열을 제공할 수 있습니다. 여러 대상 엔드포인트가 요청되면 반환된 값은 해당 엔드포인트에 대한 결합된 통계입니다. 여러 엔드포인트 통계를 단일 값으로 결합하는 데 사용되는 특정 방법은 특정 PartyEndpointStatistic 유형에 따라 달라지며 해당 유형에 설명되어 있습니다.

지정된 PartyEndpointStatistic 유형은 statisticTypes 배열에서 어떤 순서로든 나타날 수 있지만 두 번 이상 지정되어서는 안 됩니다. 각 해당 통계 값은 동일한 순서로 statisticValues 배열에 기록됩니다.

반환된 통계 값은 항상 사용 가능한 가장 최신 값입니다. 중간에 PartyManager::StartProcessingStateChanges() 또는 PartyManager::FinishProcessingStateChanges() 호출이 없더라도, 한 GetEndpointStatistics() 호출에서 다음 호출까지 동일한 값을 보고한다는 보장은 없습니다.

Requirements

Header: Party.h

See also

PartyLocalEndpoint
PartyEndpointStatistic
PartyNetwork::GetNetworkStatistics
마지막 수정일 2026년 8월 13일