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

# PFCatalogGetDraftItemAsync

> 從工作目錄擷取項目。此項目代表該項目目前的工作狀態。GetDraftItem 不會使用目錄的快取，因此在嘗試取得最近的項目更新時應使用此 API。但請注意，項目參考資料會被快取，變更可能需要一些時間才會傳播。注意：所提供的 SAS 權杖有效期為 1 小時。

從工作目錄擷取項目。此項目代表該項目目前的工作狀態。GetDraftItem 不會使用目錄的快取，因此在嘗試取得最近的項目更新時應使用此 API。但請注意，項目參考資料會被快取，變更可能需要一些時間才會傳播。注意：所提供的 SAS 權杖有效期為 1 小時。

## 語法

```cpp theme={null}
HRESULT PFCatalogGetDraftItemAsync(  
    PFEntityHandle entityHandle,  
    const PFCatalogGetDraftItemRequest* request,  
    XAsyncBlock* async  
)  
```

### 參數

**`entityHandle`**   PFEntityHandle

用於驗證的 PFEntityHandle。

**`request`**   [PFCatalogGetDraftItemRequest\*](/zh-TW/services/playfab/api-references/c/pfcatalogtypes/structs/pfcataloggetdraftitemrequest)

已填入的要求物件。

**`async`**   XAsyncBlock\*<br />*Inout*

用於非同步作業的 XAsyncBlock。

### 傳回值

類型：HRESULT

此 API 作業的結果代碼。

## 備註

此 API 可在所有平台上使用。當非同步工作完成時，請呼叫 [PFCatalogGetDraftItemGetResultSize](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetdraftitemgetresultsize) 和 [PFCatalogGetDraftItemGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetdraftitemgetresult) 以取得結果。

## 需求

**標頭：** PFCatalog.h

## 另請參閱

[PFCatalog 成員](/zh-TW/services/playfab/api-references/c/pfcatalog/pfcatalog_members)


## Related topics

- [PFCatalogGetDraftItemGetResult](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetdraftitemgetresult.md)
- [服務 C API 概觀 - PFCatalog.h](/zh-TW/services/playfab/api-references/c/pfcatalog/pfcatalog_members.md)
- [PFCatalogGetDraftItemsAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetdraftitemsasync.md)
- [PFCatalogGetEntityDraftItemsAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetentitydraftitemsasync.md)
- [PFCatalogUpdateDraftItemAsync](/zh-TW/services/playfab/api-references/c/pfcatalog/functions/pfcatalogupdatedraftitemasync.md)