Pular para o conteúdo principal

Método IXtfUserClient::PairControllerWithUser

Emparelha o usuário identificado pelo endereço de email especificado ao controle com a ID de controle especificada.

Sintaxe

Parâmetros

userName
Tipo: LPCWSTR
O endereço de email do usuário a ser emparelhado com o controle. controllerId
Tipo: UINT64
A ID de controle do controle.

Valor retornado

Tipo: HRESULT Código de sucesso ou de erro HRESULT.

Comentários

Para obter o endereço de email do usuário, chame ListUsers. Na estrutura XTF_USER_DATA retornada, examine o membro pszEmailAddress. O emparelhamento de um controle usando PairControllerWithUser é cumulativo. Se um usuário já estiver emparelhado com o controle, o usuário especificado por userName também será emparelhado com o controle. Para criar um emparelhamento exclusivo, chame PairControllerWithUserIdExclusive ou PairControllerWithUserExclusive.

Requisitos

Cabeçalho: xtfuser.h Biblioteca: xtfuser.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)

Confira também

PairControllerWithUserId
Última modificação em 6 de outubro de 2026