跳轉到主要內容

XtfGetCredentialServerName

取得儲存在 XtfGetCredentialInfoList 所傳回之 XtfNetworkCredentials 物件中某個索引處的認證伺服器名稱部分。

語法

參數

credentialInfo
類型:XtfNetworkCredentials
[in] 呼叫 XtfGetCredentialInfoList 所建立的 XtfNetworkCredentials 物件。 credentialIndex
類型:UINT32
[in] serverName 在 credentialInfo 物件中的索引。 serverName
類型:PWSTR
[out] credentialInfo 物件中指定索引處的伺服器名稱。 serverNameSize
類型:UINT32 *
[in, out] serverName 緩衝區的長度 (以 WCHAR 為單位)。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK。如果 serverName 不夠大,則傳回 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。所需的緩衝區長度會在 serverNameLength 中傳回。

備註

使用 XtfAddCredential 新增認證。使用 XtfRemoveCredential 移除認證。使用 XtfGetCredentialInfoList、XtfGetCredentialInfoCount、XtfGetCredentialServerName 和 XtfGetCredentialUserName 列舉目前儲存的認證清單。使用 XtfCloseCredentialInfoList 釋放 XtfGetCredentialInfoList 所傳回的 XtfNetworkCredentials。 如需如何使用此 API 的範例,請參閱 XtfGetCredentialInfoList。

需求

標頭: xtfapi.h 程式庫: XtfApi.lib 支援的平台: Windows (適用於 XBOX 主機工具)

另請參閱

從 PC 執行部署 (NDA 主題)
XTF 傳輸錯誤 (NDA 主題)
其他 Xtf API
最後修改於 2026年10月6日