structure NETSETUP_PROVISIONING_PARAMS (lmjoin.h)

Article
03/01/2024

La structure NETSETUP_PROVISIONING_PARAMS contient des informations utilisées lors de la création d’un package d’approvisionnement à l’aide de la fonction NetCreateProvisionPackage .

Syntaxe

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;

Membres

dwVersion

Version de Windows dans le package d’approvisionnement. Ce paramètre doit utiliser la valeur suivante définie dans le fichier d’en-tête Lmjoin.h .

Valeur	Signification
NETSETUP_PROVISIONING_PARAMS_CURRENT_VERSION 0x00000001	La version de ce package est Windows Server 2012.

lpDomain

Pointeur vers une chaîne de caractères terminée par null qui spécifie le nom du domaine dans lequel le compte d’ordinateur est créé.

lpHostName

Pointeur vers une chaîne de caractères terminée par null qui spécifie le nom court de l’ordinateur à partir duquel l’attribut de compte d’ordinateur sAMAccountName est dérivé en ajoutant un « $ ». Ce paramètre doit contenir un nom de machine DNS ou NetBIOS valide.

lpMachineAccountOU

Pointeur facultatif vers une chaîne de caractères terminée par null qui contient le nom de format RFC 1779 de l’unité d’organisation dans laquelle le compte d’ordinateur sera créé. Si vous spécifiez ce paramètre, la chaîne doit contenir un chemin d’accès complet, par exemple, OU=testOU,DC=domain,DC=com. Sinon, ce paramètre doit avoir la valeur NULL.

Si ce paramètre a la valeur NULL, le conteneur d’objets d’ordinateur connu sera utilisé comme publié dans le domaine.

lpDcName

Pointeur facultatif vers une chaîne de caractères terminée par NULL qui contient le nom du contrôleur de domaine à cibler.

dwProvisionOptions

Ensemble d’indicateurs de bits qui définissent les options d’approvisionnement. Ce paramètre peut être une ou plusieurs des valeurs suivantes définies dans le fichier d’en-tête Lmjoin.h .

Valeur	Signification
NETSETUP_PROVISION_DOWNLEVEL_PRIV_SUPPORT 0x00000001	Si l’appelant nécessite la création de compte par privilège, cette option entraîne une nouvelle tentative en cas d’échec à l’aide de fonctions de création de compte permettant l’interopérabilité avec les contrôleurs de domaine exécutés sur des versions antérieures de Windows. L’objet lpMachineAccountOU n’est pas pris en charge lors de l’utilisation de la prise en charge des privilèges de niveau inférieur.
NETSETUP_PROVISION_REUSE_ACCOUNT 0x00000002	Si le compte nommé existe déjà, une tentative de réutilisation du compte existant est effectuée. Cette option nécessite des informations d’identification suffisantes pour cette opération (administrateur de domaine ou propriétaire de l’objet).
NETSETUP_PROVISION_USE_DEFAULT_PASSWORD 0x00000004	Utilisez le mot de passe du compte d’ordinateur par défaut, qui est le nom de l’ordinateur en minuscules. Il s’agit en grande partie de prendre en charge l’ancien modèle de jointure non sécurisée où le compte précréé utilisait généralement ce mot de passe par défaut.
NETSETUP_PROVISION_SKIP_ACCOUNT_SEARCH 0x00000008	N’essayez pas de trouver le compte sur un contrôleur de domaine dans le domaine. Cette option accélère l’opération, mais ne doit être utilisée que lorsque l’appelant est certain qu’un compte du même nom n’a pas été créé récemment. Cette option n’est valide que lorsque le paramètre lpDcName est spécifié. Lorsque les conditions préalables sont remplies, cette option permet d’accélérer l’approvisionnement du doit, utile pour des scénarios tels que le traitement par lots.
NETSETUP_PROVISION_ROOT_CA_CERTS 0x00000010	Cette option récupère tous les certificats d’autorité de certification racine sur l’ordinateur local et les ajoute au package d’approvisionnement. Note Cet indicateur est uniquement pris en charge par la fonction NetCreateProvisioningPackage sur Windows 8, Windows Server 2012 et versions ultérieures.

aCertTemplateNames

Pointeur vers un tableau de noms de modèles de certificat terminés par NULL.

cCertTemplateNames

Lorsqu’unCertTemplateNames n’a pas la valeur NULL, ce membre fournit un nombre explicite du nombre d’éléments dans le tableau.

aMachinePolicyNames

Pointeur vers un tableau de noms de stratégie d’ordinateurs terminés par NULL.

cMachinePolicyNames

Lorsqu’unMachinePolicyNames n’a pas la valeur NULL, ce membre fournit un nombre explicite du nombre d’éléments dans le tableau.

aMachinePolicyPaths

Pointeur vers un tableau de chaînes de caractères. Chaque élément de tableau est une chaîne de caractères terminée par NULL qui spécifie le chemin d’accès complet ou partiel d’un fichier au format Fichier de stratégie du Registre. Pour plus d’informations sur le format de fichier de stratégie du Registre , consultez Format de fichier de stratégie du Registre

Ce chemin peut être un chemin UNC sur un serveur distant.

cMachinePolicyPaths

Lorsqu’unMachinePolicyPaths n’a pas la valeur NULL, ce membre fournit un nombre explicite du nombre d’éléments dans le tableau.

lpNetbiosName

TBD

lpSiteName

TBD

lpPrimaryDNSDomain

TBD

Remarques

La structure NETSETUP_PROVISIONING_PARAMS fournit des indicateurs pour la fonction NetCreateProvisioningPackage qui est prise en charge sur Windows 8 et Windows Server 2012 pour les opérations de jointure hors connexion.

En plus des jointures de domaine, le package d’approvisionnement peut fournir des certificats et des stratégies à l’ordinateur. Le package d’approvisionnement peut être utilisé de quatre manières :

Jonction de domaine
Jonction de domaine et installation de certificats
Jonction de domaine et installation de stratégies
Jonction de domaine et installation de certificats et de stratégies

Lorsque des certificats doivent être ajoutés au package, cette structure fournit le membre aCertTemplateNames en tant que tableau de noms de modèles de certificat terminés par NULL. Le membre aCertTemplateNames nécessite que le membre cCertTemplateNames fournisse un nombre explicite du nombre d’éléments dans le tableau.

Il existe deux façons différentes d’ajouter des stratégies. Vous pouvez utiliser une ou les deux méthodes :

Nom de la stratégie : un tableau de noms de stratégie terminés par NULL est fourni dans le membre aMachinePolicyNames . Pendant l’exécution, le nom de la stratégie est mappé au nom de la stratégie dans AD et le GUID qui représente la stratégie dans l’espace d’entreprise est récupéré. Le membre aMachinePolicyNames nécessite que le membre cMachinePolicyNames fournisse un nombre explicite du nombre d’éléments dans le tableau.
Chemin de stratégie : pointeur vers un tableau de chaînes de caractères terminées par null fournies dans le membre aMachinePolicyPaths qui spécifient le chemin d’accès à un fichier au format Fichier de stratégie du Registre. Pour plus d’informations sur le format de fichier de stratégie du Registre , consultez Format de fichier de stratégie du Registre. Le chemin d’accès de stratégie est un chemin d’accès complet ou relatif au fichier de stratégie.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
En-tête	lmjoin.h (include Lm.h)