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

# XtfGetCredentialInfoCount

> XtfGetCredentialInfoCount

# XtfGetCredentialInfoCount

取得 [XtfGetCredentialInfoList](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md) 所傳回之 `XtfNetworkCredentials` 物件中儲存的認證數目。

## 語法

```cpp theme={null}
HRESULT XtfGetCredentialInfoCount(
         XtfNetworkCredentials credentialInfo,
         UINT32* count
)  
```

### 參數

*credentialInfo*\
類型: XtfNetworkCredentials

\[in] 呼叫 [XtfGetCredentialInfoList](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md) 所建立的 `XtfNetworkCredentials` 物件。

*count*\
類型: UINT32\*

\[out] *credentialInfo* 中儲存的認證數目。

### 傳回值

類型: HRESULT

如果成功，會傳回 `S_OK`；否則會傳回 HRESULT 錯誤碼。

## 備註

使用此函式可取得 [XtfGetCredentialInfoList](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md) 函式所傳回之 `XtfNetworkCredentials` 物件中儲存的認證數目。請將此函式與 `XtfGetCredentialInfoList`、[XtfGetCredentialServerName](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialtargetname-xtfapi-xbox-windows-m.md) 和 [XtfGetCredentialUserName](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialusername-xtfapi-xbox-windows-m.md) 函式搭配使用，以列舉主機上目前已儲存的認證清單。您也可以使用 [XtfAddCredential](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfaddcredential-xtfapi-xbox-windows-m.md) 新增認證，以及使用 [XtfRemoveCredential](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfremovecredential-xtfapi-xbox-windows-m.md) 移除認證。

完成後，使用 [XtfCloseCredentialInfoList](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfclosecredentialinfo-xtfapi-xbox-windows-m.md) 釋放 `XtfGetCredentialInfoList` 所傳回的 `XtfNetworkCredentials` 物件。

如需示範如何管理和列舉已儲存認證的範例，請參閱 [XtfGetCredentialInfoList](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialinfolist-xtfapi-xbox-windows-m.md)。

## 需求

**標頭:** xtfapi.h

**程式庫:** XtfApi.lib

**支援的平台:** Windows (適用於 XBOX 主機工具)

## 另請參閱

[從 PC 執行部署 (NDA 主題)](https://docs.xbox.com/zh-TW/home/setup-install/concepts/deployment.md)\
[XTF 傳輸錯誤 (NDA 主題)](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xtf-transport-errors.md)\
[其他 Xtf API](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/atoc-xtfapi.md)


## Related topics

- [XtfRemoveCredential](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfremovecredential-xtfapi-xbox-windows-m.md)
- [XtfAddCredential](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfaddcredential-xtfapi-xbox-windows-m.md)
- [XtfCloseCredentialInfoList](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfclosecredentialinfo-xtfapi-xbox-windows-m.md)
- [XtfGetCredentialServerName](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialtargetname-xtfapi-xbox-windows-m.md)
- [XtfGetCredentialUserName](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcredentialusername-xtfapi-xbox-windows-m.md)