다음을 통해 공유


PFAuthenticationLoginWithCustomIDAsync

타이틀에서 생성된 사용자 지정 고유 식별자를 사용하여 사용자를 로그인하고, 이후에 인증된 사용자가 필요한 API 호출에 사용할 수 있는 세션 식별자를 반환합니다.

구문

HRESULT PFAuthenticationLoginWithCustomIDAsync(  
    PFServiceConfigHandle serviceConfigHandle,  
    const PFAuthenticationLoginWithCustomIDRequest* request,  
    XAsyncBlock* async  
)  

매개 변수

serviceConfigHandle PFServiceConfigHandle

PFServiceConfigCreateHandle 호출에서 반환된 PFServiceConfigHandle입니다.

request PFAuthenticationLoginWithCustomIDRequest*

채워진 요청 개체입니다.

async XAsyncBlock*
Inout

비동기 작업을 위한 XAsyncBlock입니다.

반환 값

형식: HRESULT

이 API 작업에 대한 결과 코드입니다.

설명

이 API는 모든 플랫폼에서 사용할 수 있습니다. 개발자는 한 고객이 다른 고객이 이미 사용 중인 ID를 생성할 가능성이 매우 낮음을 확인하는 것이 좋습니다. 사용자가 사용자 지정 ID로 처음 로그인하고 CreateAccount가 true로 설정된 경우 새 PlayFab 계정이 만들어지고 사용자 지정 ID에 연결됩니다. 이 경우 이메일 또는 사용자 이름이 PlayFab 계정과 연결되지 않습니다. 그렇지 않고 PlayFab 계정이 사용자 지정 ID에 연결되어 있지 않으면 이를 나타내는 오류가 반환되어 타이틀이 PlayFab 계정 생성을 통해 사용자를 안내할 수 있습니다. ClientLinkCustomIDAsync와 ClientUnlinkCustomIDAsync를 함께 참조하세요. 비동기 작업이 완료되면 PFAuthenticationLoginWithCustomIDGetResult를 호출하여 결과를 가져옵니다.

요구 사항

헤더: PFAuthentication.h

참고 항목

PFAuthentication 멤버