> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFAuthenticationServerLoginWithIOSDeviceIDRequest

> PFAuthenticationServerLoginWithIOSDeviceIDRequest 資料模型。在 iOS 裝置上，必須使用 identifierForVendor (https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIDevice_Class/index.html# // apple_ref/occ/instp/UIDevice/identifierForVendor) 作為 DeviceId，因為 UIDevice uniqueIdentifier 自 iOS 5 起已被取代，而將 advertisingIdentifier 用於此用途將導致無法通過 Apple 的認證程序。如果這是使用者第一次使用該 iOS 裝置登入，且 CreateAccount 設定為 true，系統將會建立新的 PlayFab 帳戶，並將其連結至廠商專屬的 iOS 裝置識別碼。在此情況下，不會有任何電子郵件或使用者名稱與該 PlayFab 帳戶相關聯。否則，如果沒有任何 PlayFab 帳戶連結至該 iOS 裝置，將會傳回指出此情況的錯誤，讓遊戲能引導使用者建立 PlayFab 帳戶。

PFAuthenticationServerLoginWithIOSDeviceIDRequest 資料模型。在 iOS 裝置上，必須使用 identifierForVendor ([https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIDevice\_Class/index.html#](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIDevice_Class/index.html#) // apple\_ref/occ/instp/UIDevice/identifierForVendor) 作為 DeviceId，因為 UIDevice uniqueIdentifier 自 iOS 5 起已被取代，而將 advertisingIdentifier 用於此用途將導致無法通過 Apple 的認證程序。如果這是使用者第一次使用該 iOS 裝置登入，且 CreateAccount 設定為 true，系統將會建立新的 PlayFab 帳戶，並將其連結至廠商專屬的 iOS 裝置識別碼。在此情況下，不會有任何電子郵件或使用者名稱與該 PlayFab 帳戶相關聯。否則，如果沒有任何 PlayFab 帳戶連結至該 iOS 裝置，將會傳回指出此情況的錯誤，讓遊戲能引導使用者建立 PlayFab 帳戶。

## 語法

```cpp theme={null}
typedef struct PFAuthenticationServerLoginWithIOSDeviceIDRequest {  
    bool createAccount;  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    const char* deviceId;  
    const char* deviceModel;  
    PFGetPlayerCombinedInfoRequestParams const* infoRequestParameters;  
    const char* OS;  
} PFAuthenticationServerLoginWithIOSDeviceIDRequest;  
```

### 成員

**`createAccount`**   bool

如果目前沒有 PlayFab 帳戶連結至此識別碼，則自動建立一個。

**`customTags`**   PFStringDictionaryEntry const\*<br />*may be nullptr*

（選擇性）與要求相關聯的選擇性自訂標籤（例如組建編號、外部追蹤識別碼等）。

**`customTagsCount`**   uint32\_t

customTags 的計數

**`deviceId`**   const char\*<br />*is null-terminated*

使用者裝置的廠商專屬 iOS 識別碼。

**`deviceModel`**   const char\*<br />*is null-terminated*

（選擇性）使用者裝置的特定型號。

**`infoRequestParameters`**   PFGetPlayerCombinedInfoRequestParams const\*<br />*may be nullptr*

（選擇性）指定要為使用者傳回哪些資訊的旗標。

**`OS`**   const char\*<br />*is null-terminated*

（選擇性）使用者裝置的特定作業系統版本。

## 需求

**標頭：** PFAuthenticationTypes.h

## 另請參閱

[PFAuthenticationTypes 成員](/zh-TW/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members)


## Related topics

- [PFAuthenticationServerLoginWithIOSDeviceIDAsync](/zh-TW/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationserverloginwithiosdeviceidasync.md)
- [服務 C API 概觀 - PFAuthenticationTypes.h](/zh-TW/services/playfab/api-references/c/pfauthenticationtypes/pfauthenticationtypes_members.md)
- [PFAuthenticationServerLoginWithAndroidDeviceIDRequest](/zh-TW/services/playfab/api-references/c/pfauthenticationtypes/structs/pfauthenticationserverloginwithandroiddeviceidrequest.md)
- [PFAuthenticationServerLoginWithAndroidDeviceIDAsync](/zh-TW/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationserverloginwithandroiddeviceidasync.md)
- [PFAuthenticationServerLoginWithIOSDeviceIDGetResult](/zh-TW/services/playfab/api-references/c/pfauthentication/functions/pfauthenticationserverloginwithiosdeviceidgetresult.md)