struktur NETSETUP_PROVISIONING_PARAMS (lmjoin.h)

Artikel
03/14/2023

Struktur NETSETUP_PROVISIONING_PARAMS berisi informasi yang digunakan saat membuat paket provisi menggunakan fungsi NetCreateProvisionPackage .

Sintaks

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;

Anggota

dwVersion

Versi Windows dalam paket provisi. Parameter ini harus menggunakan nilai berikut yang ditentukan dalam file header Lmjoin.h .

Nilai	Makna
NETSETUP_PROVISIONING_PARAMS_CURRENT_VERSION 0x00000001	Versi untuk paket ini adalah Windows Server 2012.

lpDomain

Penunjuk ke string karakter yang dihentikan NULL yang menentukan nama domain tempat akun komputer dibuat.

lpHostName

Penunjuk ke string karakter yang dihentikan NULL yang menentukan nama pendek komputer tempat atribut akun komputer sAMAccountName diturunkan dengan menambahkan '$'. Parameter ini harus berisi nama komputer DNS atau NetBIOS yang valid.

lpMachineAccountOU

Penunjuk opsional ke string karakter yang dihentikan NULL yang berisi nama format RFC 1779 dari unit organisasi (OU) tempat akun komputer akan dibuat. Jika Anda menentukan parameter ini, string harus berisi jalur lengkap, misalnya, OU=testOU,DC=domain,DC=Domain,DC=com. Jika tidak, parameter ini harus NULL.

Jika parameter ini NULL, kontainer objek komputer yang terkenal akan digunakan seperti yang diterbitkan di domain.

lpDcName

Penunjuk opsional ke string karakter yang dihentikan NULL yang berisi nama pengendali domain yang akan ditargetkan.

dwProvisionOptions

Sekumpulan bendera bit yang menentukan opsi provisi. Parameter ini dapat berupa satu atau beberapa nilai berikut yang ditentukan dalam file header Lmjoin.h .

Nilai	Makna
NETSETUP_PROVISION_DOWNLEVEL_PRIV_SUPPORT 0x00000001	Jika pemanggil memerlukan pembuatan akun dengan hak istimewa, opsi ini akan menyebabkan percobaan kembali pada kegagalan menggunakan fungsi pembuatan akun yang memungkinkan interoperabilitas dengan pengontrol domain yang berjalan pada versi Windows yang lebih lama. lpMachineAccountOU tidak didukung saat menggunakan dukungan hak istimewa downlevel.
NETSETUP_PROVISION_REUSE_ACCOUNT 0x00000002	Jika akun bernama sudah ada, upaya akan dilakukan untuk menggunakan kembali akun yang ada. Opsi ini memerlukan kredensial yang memadai untuk operasi ini (Administrator Domain atau pemilik objek).
NETSETUP_PROVISION_USE_DEFAULT_PASSWORD 0x00000004	Gunakan kata sandi akun komputer default yang merupakan nama komputer dalam huruf kecil. Ini sebagian besar untuk mendukung model gabungan lama yang tidak aman di mana akun yang telah dibuat sebelumnya biasanya menggunakan kata sandi default ini.
NETSETUP_PROVISION_SKIP_ACCOUNT_SEARCH 0x00000008	Jangan mencoba menemukan akun pada pengendali domain apa pun di domain. Opsi ini membuat operasi lebih cepat, tetapi hanya boleh digunakan ketika pemanggil yakin bahwa akun dengan nama yang sama belum dibuat baru-baru ini. Opsi ini hanya valid ketika parameter lpDcName ditentukan. Ketika prasyarat terpenuhi, opsi ini memungkinkan provisi harus lebih cepat yang berguna untuk skenario seperti pemrosesan batch.
NETSETUP_PROVISION_ROOT_CA_CERTS 0x00000010	Opsi ini mengambil semua sertifikat Otoritas Sertifikat akar pada komputer lokal dan menambahkannya ke paket provisi. Catatan Bendera ini hanya didukung oleh fungsi NetCreateProvisioningPackage pada Windows 8, Windows Server 2012, dan yang lebih baru.

aCertTemplateNames

Penunjuk ke array nama templat sertifikat yang dihentikan NULL.

cCertTemplateNames

Ketika aCertTemplateNames bukan NULL, anggota ini menyediakan jumlah eksplisit jumlah item dalam array.

aMachinePolicyNames

Penunjuk ke array nama kebijakan komputer yang dihentikan NULL.

cMachinePolicyNames

Ketika aMachinePolicyNames bukan NULL, anggota ini menyediakan jumlah eksplisit jumlah item dalam array.

aMachinePolicyPaths

Penunjuk ke array string karakter. Setiap elemen array adalah string karakter yang dihentikan NULL yang menentukan jalur lengkap atau sebagian ke file dalam format File Kebijakan Registri. Untuk informasi selengkapnya tentang Format File Kebijakan Registri, lihat Format File Kebijakan Registri

Jalur ini bisa menjadi jalur UNC pada server jarak jauh.

cMachinePolicyPaths

Ketika aMachinePolicyPaths bukan NULL, anggota ini menyediakan jumlah eksplisit jumlah item dalam array.

lpNetbiosName

TBD

lpSiteName

TBD

lpPrimaryDNSDomain

TBD

Keterangan

Struktur NETSETUP_PROVISIONING_PARAMS menyediakan bendera untuk fungsi NetCreateProvisioningPackage yang didukung pada Windows 8 dan Windows Server 2012 untuk operasi gabungan offline.

Selain gabungan domain, paket provisi dapat memberikan sertifikat dan kebijakan ke komputer. Paket provisi dapat digunakan dengan empat cara:

Bergabung ke Domain
Gabungan domain dan penginstalan sertifikat
Gabungan domain dan penginstalan kebijakan
Gabungan domain dan penginstalan sertifikat dan kebijakan

Ketika sertifikat perlu ditambahkan ke paket, struktur ini menyediakan anggota aCertTemplateNames sebagai array nama templat sertifikat yang dihentikan NULL. Anggota aCertTemplateNames mengharuskan anggota cCertTemplateNames untuk memberikan jumlah eksplisit jumlah item dalam array.

Ada dua cara berbeda untuk menambahkan kebijakan. Anda dapat menggunakan satu atau kedua metode:

Nama kebijakan—Array nama kebijakan yang dihentikan NULL disediakan di anggota aMachinePolicyNames . Selama runtime, nama kebijakan dipetakan ke nama kebijakan di AD dan GUID yang mewakili kebijakan di ruang perusahaan diambil. Anggota aMachinePolicyNames mengharuskan anggota cMachinePolicyNames untuk memberikan jumlah eksplisit jumlah item dalam array.
Jalur kebijakan—Penunjuk ke array string karakter yang dihentikan NULL yang disediakan di anggota aMachinePolicyPaths yang menentukan jalur ke file dalam format File Kebijakan Registri. Untuk informasi selengkapnya tentang Format File Kebijakan Registri, lihat Format File Kebijakan Registri. Jalur kebijakan adalah jalur lengkap atau relatif ke file kebijakan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Header	lmjoin.h (termasuk Lm.h)