(lmjoin.h) NETSETUP_PROVISIONING_PARAMS 结构

项目
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	此选项检索本地计算机上的所有根证书颁发机构证书，并将其添加到预配包。注意此标志仅受 Windows 8、Windows Server 2012 及更高版本上的 NetCreateProvisioningPackage 函数支持。

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 成员提供数组中项数的显式计数。
策略路径 - 指向在 aMachinePolicyPaths 成员中提供的以 NULL 结尾的字符串数组的指针，这些字符串以注册表策略文件格式指定文件的路径。有关注册表策略文件格式的详细信息，请参阅注册表策略文件格式。策略路径是策略文件的完整路径或相对路径。

要求

要求	值
最低受支持的客户端	Windows 8 [仅限桌面应用]
最低受支持的服务器	Windows Server 2012 [仅限桌面应用]
标头	lmjoin.h (包括 Lm.h)