IXtfUserClient::ListUsers
현재 이 콘솔과 연결된 모든 사용자의 목록을 반환합니다.Syntax
Parameters
ppUserDataType: XTF_USER_DATA ** 성공적으로 반환되면, 콘솔과 현재 연결된 사용자를 설명하는 XTF_USER_DATA 객체의 배열을 가리킵니다. pCount
Type: UINT32 * 성공적으로 반환되면, ppUserData 배열의 요소 개수입니다.
Return value
Type: HRESULT HRESULT 성공 또는 오류 코드.Remarks
호출 코드는CoTaskMemFree를 사용하여 ppUserData와 관련된 메모리를 해제해야 합니다.
사용자가 후원(게스트) 사용자인 경우, XTF_USER_DATA 객체의 szEmailAddress 값은 빈 문자열이며, szGamertag는 후원 사용자의 게이머태그에서 파생됩니다.
사용자가 이 콘솔에 한 번도 로그인한 적이 없는 경우, szGamertag는 빈 문자열입니다.
이 콘솔에 사용자를 추가하려면 AddUser를 사용하세요. 게스트 사용자를 추가하려면 AddSponsoredUser를 사용하세요.