NETSETUP_PROVISIONING_PARAMS structure (lmjoin.h)

The NETSETUP_PROVISIONING_PARAMS structure contains information that is used when creating a provisioning package using the NetCreateProvisionPackage function.

Syntax

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;

Members

dwVersion

The version of Windows in the provisioning package. This parameter should use the following value defined in the Lmjoin.h header file.

lpDomain

A pointer to a NULL-terminated character string that specifies the name of the domain where the computer account is created.

lpHostName

A pointer to a NULL-terminated character string that specifies the short name of the machine from which the computer account attribute sAMAccountName is derived by appending a '$'. This parameter must contain a valid DNS or NetBIOS machine name.

lpMachineAccountOU

A optional pointer to a NULL-terminated character string that contains the RFC 1779 format name of the organizational unit (OU) where the computer account will be created. If you specify this parameter, the string must contain a full path, for example, OU=testOU,DC=domain,DC=Domain,DC=com. Otherwise, this parameter must be NULL.

If this parameter is NULL, the well known computer object container will be used as published in the domain.

lpDcName

An optional pointer to a NULL-terminated character string that contains the name of the domain controller to target.

dwProvisionOptions

A set of bit flags that define provisioning options. This parameter can be one or more of the following values defined in the Lmjoin.h header file.

aCertTemplateNames

A pointer to an array of NULL-terminated certificate template names.

cCertTemplateNames

When aCertTemplateNames is not NULL, this member provides an explicit count of the number of items in the array.

aMachinePolicyNames

A pointer to an array of NULL-terminated machine policy names.

cMachinePolicyNames

When aMachinePolicyNames is not NULL, this member provides an explicit count of the number of items in the array.

aMachinePolicyPaths

A pointer to an array of character strings. Each array element is a NULL-terminated character string which specifies the full or partial path to a file in the Registry Policy File format. For more information on the Registry Policy File Format , see Registry Policy File Format

This path could be a UNC path on a remote server.

cMachinePolicyPaths

When aMachinePolicyPaths is not NULL, this member provides an explicit count of the number of items in the array.

lpNetbiosName

TBD

lpSiteName

TBD

lpPrimaryDNSDomain

TBD

Remarks

The NETSETUP_PROVISIONING_PARAMS structure provides flags for the NetCreateProvisioningPackage function which is supported on Windows 8 and Windows Server 2012 for offline join operations.

In addition to domain joins, the provisioning package can provide certificates and policies to the machine. The provisioning package can be used in four ways:

• Domain join
• Domain join and installation of certificates
• Domain join and installation of policies
• Domain join and installation of certificates and policies

When certificates need to be added to the package, this structure provides the aCertTemplateNames member as an array of NULL-terminated certificate template names. The aCertTemplateNames member requires the cCertTemplateNames member to provide an explicit count of the number of items in the array.

There are two different ways to add policies. You can use one or both methods:

• Policy name—An array of NULL-terminated policy names is provided in the aMachinePolicyNames member. During runtime, the policy name is mapped to the policy name in AD and the GUID that represents the policy in the enterprise space is retrieved. The aMachinePolicyNames member requires the cMachinePolicyNames member to provide an explicit count of the number of items in the array.
• Policy path—A pointer to an array of NULL-terminated character strings provided in the aMachinePolicyPaths member which specify the path to a file in the Registry Policy File format. For more information on the Registry Policy File Format , see Registry Policy File Format. The policy path is a full or relative path to the policy file.

Requirements

See also

NetCreateProvisionPackage

NetJoinDomain

NetProvisionComputerAccount

NetRenameMachineInDomain

NetRequestOfflineDomainJoin

NetRequestProvisioningPackageInstall

NetUnjoinDomain

Network Management Functions

Network Management Overview