> ## 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.

# PFLeaderboardsCreateLeaderboardDefinitionRequest

> PFLeaderboardsCreateLeaderboardDefinitionRequest 資料模型。

PFLeaderboardsCreateLeaderboardDefinitionRequest 資料模型。

## 語法

```cpp theme={null}
typedef struct PFLeaderboardsCreateLeaderboardDefinitionRequest {  
    PFLeaderboardsLeaderboardColumn const* columns;  
    uint32_t columnsCount;  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    const char* entityType;  
    PFLeaderboardsLeaderboardEventEmissionConfig const* eventEmissionConfig;  
    const char* name;  
    int32_t sizeLimit;  
    PFVersionConfiguration const* versionConfiguration;  
} PFLeaderboardsCreateLeaderboardDefinitionRequest;  
```

### 成員

**`columns`**   [PFLeaderboardsLeaderboardColumn](/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsleaderboardcolumn) const\*

描述排序方向的排行榜資料行，建立後即無法變更。最多允許 5 個資料行。

**`columnsCount`**   uint32\_t

columns 的計數

**`customTags`**   [PFStringDictionaryEntry](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

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

**`customTagsCount`**   uint32\_t

customTags 的計數

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

排行榜上所代表的實體類型。如果不對應於 PlayFab 實體類型，請使用 'external' 作為類型。

**`eventEmissionConfig`**   [PFLeaderboardsLeaderboardEventEmissionConfig](/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsleaderboardeventemissionconfig) const\*<br />*may be nullptr*

（選擇性）\[預覽中]：此排行榜所發出事件的組態。如果未指定，將不會發出任何事件。

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

排行榜的名稱，在每個 Title 中必須唯一。

**`sizeLimit`**   int32\_t

此排行榜的項目數上限。

**`versionConfiguration`**   PFVersionConfiguration const\*<br />*may be nullptr*

（選擇性）排行榜定義的版本重設組態。

## 需求

**標頭：** PFLeaderboardsTypes.h

## 另請參閱

[PFLeaderboardsTypes 成員](/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members)


## Related topics

- [PFLeaderboardsCreateLeaderboardDefinitionAsync](/zh-TW/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardscreateleaderboarddefinitionasync.md)
- [服務 C API 概觀 - PFLeaderboardsTypes.h](/zh-TW/services/playfab/api-references/c/pfleaderboardstypes/pfleaderboardstypes_members.md)
- [PFLeaderboardsDeleteLeaderboardDefinitionRequest](/zh-TW/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsdeleteleaderboarddefinitionrequest.md)
- [PFLeaderboardsGetLeaderboardDefinitionRequest](/zh-TW/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsgetleaderboarddefinitionrequest.md)
- [PFLeaderboardsListLeaderboardDefinitionsRequest](/zh-TW/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardslistleaderboarddefinitionsrequest.md)