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

# XtfRegisterNetworkSharePackage

> XtfRegisterNetworkSharePackage

# XtfRegisterNetworkSharePackage

為[從 PC 執行部署 (NDA 主題)](https://docs.xbox.com/zh-TW/home/setup-install/concepts/deployment.md) 註冊套件。\
\[!NOTE] 在此版本中，當 [XtfRegisterNetworkSharePackage](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfregisternetworksharepackage-xtfapi-xbox-windows-m.md) 透過網路將密碼文字傳遞至主機時，密碼文字不會加密。如需如何建立低權限使用者帳戶以搭配此功能使用的詳細資訊，請參閱[從 PC 執行部署 (NDA 主題)](https://docs.xbox.com/zh-TW/home/setup-install/concepts/deployment.md)。

## 語法

```cpp theme={null}
HRESULT XtfRegisterNetworkSharePackage(
         LPCWSTR address,
         LPCWSTR sharePath,
         LPCWSTR userName,
         LPCWSTR password,
         XtfPackageInfo *packageInfo
)  
```

### 參數

*address*\
類型：LPCWSTR

\[in] 主機的位址。

*sharePath*\
類型：LPCWSTR

\[in] 要註冊之開發 PC 上的共用路徑。

*userName*\
類型：LPCWSTR

\[in] 要使用的使用者名稱，格式為 domain\user。可以是 L""。

*password*\
類型：LPCWSTR

\[in, out] 使用者的密碼。未加密。可以是 L""。

*packageInfo*\
類型：XtfPackageInfo \*

\[out] 已註冊之套件的套件資訊物件。

### 傳回值

類型：HRESULT

傳回值為 **S\_OK** 表示函式成功。任何其他值都表示發生非預期的錯誤。

## 備註

如果 userName 和 password 等於 L""，則會使用透過 [XtfAddCredential](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfaddcredential-xtfapi-xbox-windows-m.md) 為 sharePath 註冊的認證。

使用 [XtfGetPackageFullName](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md)、[XtfGetCountofAppUserModelIds](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m.md) 和 [XtfGetAumid](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m.md) 從 packageInfo 物件擷取資訊。使用完 packageInfo 物件後，請使用 [XtfClosePackageInfo](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfclosepackageinfo-xtfapi-xbox-windows-m.md) 將其釋放。

## 需求

**標頭：** xtfapi.h

**程式庫：** XtfApi.lib

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

## 另請參閱

[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

- [XtfGetPackageFullName](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md)
- [XtfGetAumid](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m.md)
- [XtfGetCountofAppUserModelIds](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m.md)
- [XtfClosePackageInfo](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/functions/xtfclosepackageinfo-xtfapi-xbox-windows-m.md)
- [其他 Xtf API (API 內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfapi/atoc-xtfapi.md)
