IXtfUserClient::ListUsers
Retorna uma lista de todos os usuários associados atualmente a este console.Sintaxe
Parâmetros
ppUserDataTipo: XTF_USER_DATA ** Em caso de retorno bem-sucedido, aponta para uma matriz de objetos XTF_USER_DATA que descrevem os usuários associados atualmente ao console. pCount
Tipo: UINT32 * Em caso de retorno bem-sucedido, a contagem de elementos na matriz ppUserData.
Valor retornado
Tipo: HRESULT Código de sucesso ou de erro HRESULT.Comentários
Seu código de chamada é responsável por liberar a memória associada a ppUserData usandoCoTaskMemFree.
Se um usuário for um usuário patrocinado (convidado), o valor de szEmailAddress no objeto XTF_USER_DATA será uma cadeia de caracteres vazia, e szGamertag será derivado do gamertag do usuário patrocinador.
Se um usuário nunca tiver entrado neste console, szGamertag será uma cadeia de caracteres vazia.
Para adicionar um usuário a este console, use AddUser. Para adicionar um usuário convidado, use AddSponsoredUser.