struttura NETSETUP_PROVISIONING_PARAMS (lmjoin.h)
La struttura NETSETUP_PROVISIONING_PARAMS contiene informazioni utilizzate durante la creazione di un pacchetto di provisioning tramite la funzione NetCreateProvisionPackage .
Sintassi
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
Versione di Windows nel pacchetto di provisioning. Questo parametro deve usare il valore seguente definito nel file di intestazione Lmjoin.h .
| Valore | Significato |
|---|---|
|
La versione per questo pacchetto è Windows Server 2012. |
lpDomain
Puntatore a una stringa di caratteri con terminazione NULL che specifica il nome del dominio in cui viene creato l'account computer.
lpHostName
Puntatore a una stringa di caratteri con terminazione NULL che specifica il nome breve del computer da cui deriva l'attributo dell'account computer sAMAccountName aggiungendo un valore '$'. Questo parametro deve contenere un nome di computer DNS o NetBIOS valido.
lpMachineAccountOU
Puntatore facoltativo a una stringa di caratteri con terminazione NULL contenente il nome di formato RFC 1779 dell'unità organizzativa in cui verrà creato l'account computer. Se si specifica questo parametro, la stringa deve contenere un percorso completo, ad esempio OU=testOU,DC=domain,DC=Domain,DC=com. In caso contrario, questo parametro deve essere NULL.
Se questo parametro è NULL, il contenitore di oggetti computer noto verrà usato come pubblicato nel dominio.
lpDcName
Puntatore facoltativo a una stringa di caratteri con terminazione NULL contenente il nome del controller di dominio di destinazione.
dwProvisionOptions
Set di flag di bit che definiscono le opzioni di provisioning. Questo parametro può essere uno o più dei valori seguenti definiti nel file di intestazione Lmjoin.h .
| Valore | Significato |
|---|---|
|
Se il chiamante richiede la creazione dell'account tramite privilegio, questa opzione causerà un nuovo tentativo in caso di errore usando le funzioni di creazione dell'account che consentono l'interoperabilità con i controller di dominio in esecuzione nelle versioni precedenti di Windows.
LpMachineAccountOU non è supportato quando si usa il supporto dei privilegi di livello inferiore. |
|
Se l'account denominato esiste già, verrà effettuato un tentativo di riutilizzare l'account esistente.
Questa opzione richiede credenziali sufficienti per questa operazione (amministratore di dominio o proprietario dell'oggetto). |
|
Usare la password dell'account computer predefinita, ovvero il nome del computer in lettere minuscole. Questo è in gran parte per supportare il modello di join non sicuro precedente in cui l'account creato in genere usava questa password predefinita. |
|
Non tentare di trovare l'account in alcun controller di dominio nel dominio. Questa opzione rende l'operazione più veloce, ma deve essere usata solo quando il chiamante è certo che un account con lo stesso nome non sia stato creato di recente.
Questa opzione è valida solo quando viene specificato il parametro lpDcName . Quando vengono soddisfatti i prerequisiti, questa opzione consente il provisioning più rapido utile per scenari come l'elaborazione batch. |
|
Questa opzione recupera tutti i certificati dell'autorità di certificazione radice nel computer locale e li aggiunge al pacchetto di provisioning.
Nota Questo flag è supportato solo dalla funzione NetCreateProvisioningPackage in Windows 8, Windows Server 2012 e versioni successive.
|
aCertTemplateNames
Puntatore a una matrice di nomi di modelli di certificato con terminazione NULL.
cCertTemplateNames
Quando aCertTemplateNames non è NULL, questo membro fornisce un conteggio esplicito del numero di elementi nella matrice.
aMachinePolicyNames
Puntatore a una matrice di nomi di criteri computer con terminazione NULL.
cMachinePolicyNames
Quando aMachinePolicyNames non è NULL, questo membro fornisce un conteggio esplicito del numero di elementi nella matrice.
aMachinePolicyPaths
Puntatore a una matrice di stringhe di caratteri. Ogni elemento della matrice è una stringa di caratteri con terminazione NULL che specifica il percorso completo o parziale di un file nel formato file dei criteri del Registro di sistema. Per altre informazioni sul formato del file dei criteri del Registro di sistema, vedere Formato di file dei criteri del Registro di sistema
Questo percorso può essere un percorso UNC in un server remoto.
cMachinePolicyPaths
Quando aMachinePolicyPaths non è NULL, questo membro fornisce un conteggio esplicito del numero di elementi nella matrice.
lpNetbiosName
TBD
lpSiteName
TBD
lpPrimaryDNSDomain
TBD
Commenti
La struttura NETSETUP_PROVISIONING_PARAMS fornisce flag per la funzione NetCreateProvisioningPackage supportata in Windows 8 e Windows Server 2012 per le operazioni di join offline.
Oltre ai join di dominio, il pacchetto di provisioning può fornire certificati e criteri al computer. Il pacchetto di provisioning può essere usato in quattro modi:
- Aggiunta a un dominio
- Aggiunta a un dominio e installazione di certificati
- Aggiunta a un dominio e installazione dei criteri
- Aggiunta a un dominio e installazione di certificati e criteri
Quando i certificati devono essere aggiunti al pacchetto, questa struttura fornisce il membro aCertTemplateNames come matrice di nomi di modelli di certificato con terminazione NULL. Il membro aCertTemplateNames richiede al membro cCertTemplateNames di fornire un conteggio esplicito del numero di elementi nella matrice.
Esistono due modi diversi per aggiungere criteri. È possibile usare uno o entrambi i metodi:
- Nome criterio: nel membro aMachinePolicyNames viene fornita una matrice di nomi di criteri con terminazione NULL. Durante il runtime, il nome del criterio viene mappato al nome del criterio in AD e il GUID che rappresenta i criteri nello spazio aziendale viene recuperato. Il membro aMachinePolicyNames richiede al membro cMachinePolicyNames di fornire un conteggio esplicito del numero di elementi nella matrice.
- Percorso dei criteri: puntatore a una matrice di stringhe di caratteri con terminazione NULL fornita nel membro aMachinePolicyPaths che specifica il percorso di un file nel formato file dei criteri del Registro di sistema. Per altre informazioni sul formato del file di criteri del Registro di sistema, vedere Formato di file dei criteri del Registro di sistema. Il percorso dei criteri è un percorso completo o relativo del file di criteri.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Intestazione | lmjoin.h (include Lm.h) |