NETSETUP_PROVISIONING_PARAMS 結構 (lmjoin.h)

發行項
02/28/2024

NETSETUP_PROVISIONING_PARAMS 結構包含使用 NetCreateProvisionPackage 函式建立布建套件時所使用的資訊。

語法

typedef struct _NETSETUP_PROVISIONING_PARAMS {
  DWORD   dwVersion;
  LPCWSTR lpDomain;
  LPCWSTR lpHostName;
  LPCWSTR lpMachineAccountOU;
  LPCWSTR lpDcName;
  DWORD   dwProvisionOptions;
  LPCWSTR *aCertTemplateNames;
  DWORD   cCertTemplateNames;
  LPCWSTR *aMachinePolicyNames;
  DWORD   cMachinePolicyNames;
  LPCWSTR *aMachinePolicyPaths;
  DWORD   cMachinePolicyPaths;
  LPWSTR  lpNetbiosName;
  LPWSTR  lpSiteName;
  LPWSTR  lpPrimaryDNSDomain;
} NETSETUP_PROVISIONING_PARAMS, *PNETSETUP_PROVISIONING_PARAMS;

成員

dwVersion

布建套件中的 Windows 版本。此參數應該使用 Lmjoin.h 頭檔中定義的下列值。

值	意義
NETSETUP_PROVISIONING_PARAMS_CURRENT_VERSION 0x00000001	此套件的版本 Windows Server 2012。

lpDomain

NULL 終止字元字串的指標，指定建立計算機帳戶之網域的名稱。

lpHostName

NULL 終止字元字串的指標，指定計算機帳戶屬性 sAMAccountName 衍生來源之計算機的簡短名稱，方法是附加『$』。此參數必須包含有效的 DNS 或 NetBIOS 機器名稱。

lpMachineAccountOU

NULL 終止字元字串的選擇性指標，其中包含將建立計算機帳戶之組織單位 (OU) RFC 1779 格式名稱。如果您指定此參數，字串必須包含完整路徑，例如 OU=testOU，DC=domain，DC=Domain，DC=com。否則，此參數必須是 NULL。

如果此參數為 NULL，則已知計算機物件容器將作為在網域中發佈。

lpDcName

NULL 終止字元字串的選擇性指標，其中包含要設為目標的域控制器名稱。

dwProvisionOptions

定義布建選項的一組位旗標。此參數可以是 Lmjoin.h 頭檔中定義的下列一或多個值。

值	意義
NETSETUP_PROVISION_DOWNLEVEL_PRIV_SUPPORT 0x00000001	如果呼叫端需要以許可權建立帳戶，此選項將會使用帳戶建立函式來重試失敗，以便與在舊版 Windows 上執行的域控制器互通。使用下層許可權支援時，不支援 lpMachineAccountOU 。
NETSETUP_PROVISION_REUSE_ACCOUNT 0x00000002	如果具名帳戶已經存在，將會嘗試重複使用現有的帳戶。此選項需要足夠的認證，才能進行這項作業， (網域管理員或對象擁有者) 。
NETSETUP_PROVISION_USE_DEFAULT_PASSWORD 0x00000004	使用預設電腦帳戶密碼，這是小寫的計算機名稱。這主要是為了支援較舊的不安全聯結模型，其中預先建立的帳戶通常會使用此默認密碼。
NETSETUP_PROVISION_SKIP_ACCOUNT_SEARCH 0x00000008	請勿嘗試在網域中的任何域控制器上尋找帳戶。此選項可讓作業更快速，但只有在呼叫端確定最近尚未建立相同名稱的帳戶時使用。只有在指定 lpDcName 參數時，此選項才有效。當符合必要條件時，此選項可讓布建更快速，適用於批處理等案例。
NETSETUP_PROVISION_ROOT_CA_CERTS 0x00000010	此選項會擷取本機計算機上的所有跟證書授權單位憑證，並將其新增至布建套件。注意只有 netCreateProvisioningPackage 函式支援此旗標，Windows 8、Windows Server 2012 及更新版本。

aCertTemplateNames

NULL 終止證書範本名稱陣列的指標。

cCertTemplateNames

當 aCertTemplateNames 不是 NULL 時，這個成員會提供數位中項目的明確計數。

aMachinePolicyNames

NULL 終止計算機原則名稱陣列的指標。

cMachinePolicyNames

當 aMachinePolicyNames 不是 NULL 時，此成員會提供數位中項目的明確計數。

aMachinePolicyPaths

字元字串數位的指標。每個陣列元素都是NULL終止的字元字串，指定登錄原則檔格式之檔案的完整或部分路徑。如需登錄原則檔格式的詳細資訊，請參閱登錄原則檔格式

此路徑可能是遠端伺服器上的 UNC 路徑。

cMachinePolicyPaths

當 aMachinePolicyPaths 不是 NULL 時，此成員會提供數位中項目的明確計數。

lpNetbiosName

TBD

lpSiteName

TBD

lpPrimaryDNSDomain

TBD

備註

NETSETUP_PROVISIONING_PARAMS 結構提供 NetCreateProvisioningPackage 函式的旗標，此函式支援 Windows 8 和離線聯結作業的 Windows Server 2012。

除了加入網域之外，布建套件還可以將憑證和原則提供給計算機。佈建套件可以透過四種方式使用：

網域加入
加入網域並安裝憑證
網域加入和安裝原則
加入網域並安裝憑證和原則

當憑證需要新增至封裝時，此結構會提供 aCertTemplateNames 成員作為 NULL 終止證書範本名稱的陣列。 aCertTemplateNames 成員需要 cCertTemplateNames 成員，才能提供陣列中項目的明確計數。

有兩種不同的方式可以新增原則。您可以使用或兩種方法：

原則名稱- AMachinePolicyNames 成員中會提供 NULL 終止的原則名稱數位。在運行時間期間，原則名稱會對應至 AD 中的原則名稱，並擷取代表企業空間中原則的 GUID。 aMachinePolicyNames 成員需要 cMachinePolicyNames 成員，才能提供陣列中項目的明確計數。
原則路徑- A 指標，指向 aMachinePolicyPaths 成員中提供的 NULL 終止字元字串陣列陣列，指定登錄原則檔格式之檔案的路徑。如需登錄原則檔格式的詳細資訊，請參閱登錄原則檔格式。原則路徑是原則檔案的完整或相對路徑。

規格需求

需求	值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
標頭	lmjoin.h (包含 Lm.h)