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

# XtfRegisterNetworkSharePackage

> XtfRegisterNetworkSharePackage

# XtfRegisterNetworkSharePackage

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

<a id="syntaxSection" />

## 語法

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

<a id="ID4ET" />

### 參數

*address*\
類型：LPCWSTR

\[in] 主機的位址。

*sharePath*\
類型：LPCWSTR

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

*userName*\
類型：LPCWSTR

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

*password*\
類型：LPCWSTR

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

*packageInfo*\
類型：XtfPackageInfo \*

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

<a id="ID4E1" />

### 傳回值

類型：HRESULT

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

<a id="remarks" />

## 備註

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

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

## 需求

**標頭：** xtfapi.h

**程式庫：** XtfApi.lib

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

## 另請參閱

[XTF 傳輸錯誤 (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xtf-transport-errors)\
[其他 Xtf API](/zh-TW/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XtfGetPackageFullName](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetpackagefullname-xtfapi-xbox-windows-m.md)
- [XtfGetAumid](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetaumid-xtfapi-xbox-windows-m.md)
- [XtfGetCountofAppUserModelIds](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfgetcountofappusermodelids-xtfapi-xbox-windows-m.md)
- [XtfClosePackageInfo](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfclosepackageinfo-xtfapi-xbox-windows-m.md)
- [XtfRegisterPackage](/zh-TW/reference/tools/xtf/xtfapi/functions/xtfregisterpackage-xtfapi-xbox-windows-m.md)