다음을 통해 공유


PartyLocalEndpoint::GetEndpointStatistics

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

구문

PartyError GetEndpointStatistics(  
    uint32_t targetEndpointCount,  
    PartyEndpointArray targetEndpoints,  
    uint32_t statisticCount,  
    const PartyEndpointStatistic* statisticTypes,  
    uint64_t* statisticValues  
)  

매개 변수

targetEndpointCount uint32_t

targetEndpoints 배열의 대상 엔드포인트 수입니다. 이 로컬 엔드포인트를 포함하여 현재 네트워크에 있는 모든 엔드포인트의 통계를 검색하려면 0일 수 있습니다.

targetEndpointsPartyEndpointArray
크기의 입력 배열targetEndpointCount

통계를 검색할 대상 PartyEndpoint 개체 포인터의 targetEndpointCount 항목 배열입니다. targetEndpointCount가 0이면 무시됩니다.

statisticCount uint32_t

입력 statisticTypes 배열의 통계 수이며 statisticValues 출력 배열에 기록됩니다. 이 값은 1 이상이어야 합니다.

statisticTypesPartyEndpointStatistic*
크기의 입력 배열statisticCount

검색할 고유한 PartyEndpointStatistic 형식의 statisticCount 항목 입력 배열입니다.

statisticValues uint64_t*
크기의 출력 배열statisticCount

통계 값이 기록될 statisticCount 항목 출력 배열입니다. 각 통계 값은 요청된 PartyEndpointStatistic이 statisticTypes 입력 배열에 표시되는 위치에 해당하는 동일한 항목 인덱스에 기록됩니다.

반환 값

PartyError

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

비고

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

또는 여러 대상 엔드포인트를 제공할 수도 있고 0개 항목 배열을 제공하여 이 로컬 엔드포인트를 포함하여 현재 네트워크에 있는 모든 대상 엔드포인트의 통계를 검색할 수도 있습니다. 여러 대상 엔드포인트를 요청하면 해당 엔드포인트의 통계가 통합된 값이 반환됩니다. 여러 엔드포인트 통계를 단일 값으로 결합하는 데 사용되는 특정 메서드는 특정 PartyEndpointStatistic 형식에 따라 달라지며 해당 형식에서 설명합니다.

지정된 PartyEndpointStatistic 형식은 statisticTypes 배열에서 임의의 순서로 표시해도 되지만 두 번 이상 지정해서는 안 됩니다. 각 해당 통계 값은 statisticValues 배열에 동일한 순서로 기록됩니다.

반환되는 통계 값은 항상 사용 가능한 최신 통계입니다. PartyManager::StartProcessingStateChanges() 또는 PartyManager::FinishProcessingStateChanges()에 대한 중간 호출이 없더라도 GetEndpointStatistics()의 이번 호출과 다음 호출에서 같은 값을 보고한다는 보장은 없습니다.

요구 사항

헤더: Party.h

참고 항목

PartyLocalEndpoint
PartyEndpointStatistic
PartyNetwork::GetNetworkStatistics