structure NETSETUP_PROVISIONING_PARAMS (lmjoin.h)
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 |
|---|---|
|
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 |
|---|---|
|
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. |
|
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). |
|
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. |
|
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. |
|
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) |