Fungsi NetRequestOfflineDomainJoin (lmjoin.h)

Artikel
03/14/2023

Fungsi NetRequestOfflineDomainJoin dijalankan secara lokal pada komputer untuk memodifikasi gambar sistem operasi Windows yang dipasang pada volume. Registri dimuat dari data blob gambar dan provisi ditulis di mana registri dapat diambil selama fase penyelesaian operasi gabungan domain offline.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetRequestOfflineDomainJoin(
  [in] BYTE    *pProvisionBinData,
  [in] DWORD   cbProvisionBinDataSize,
  [in] DWORD   dwOptions,
  [in] LPCWSTR lpWindowsPath
);

Parameter

[in] pProvisionBinData

Penunjuk ke buffer yang diperlukan untuk menginisialisasi registri citra sistem operasi Windows untuk memproses perubahan status lokal akhir selama fase penyelesaian operasi gabungan domain offline.

Blob biner buram dari metadata berseri yang diteruskan dalam parameter pProvisionBinData dikembalikan oleh fungsi NetProvisionComputerAccount .

[in] cbProvisionBinDataSize

Ukuran, dalam byte, dari buffer yang diacu oleh parameter pProvisionBinData .

Parameter ini tidak boleh NULL.

[in] dwOptions

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

Nilai	Makna
NETSETUP_PROVISION_ONLINE_CALLER 0x40000000	Bendera ini diperlukan jika parameter lpWindowsPath mereferensikan direktori sistem operasi Windows yang sedang berjalan daripada gambar sistem operasi Windows offline yang dipasang pada volume yang dapat diakses. Jika bendera ini ditentukan, fungsi NetRequestOfflineDomainJoin harus dipanggil oleh anggota grup Administrator lokal.

[in] lpWindowsPath

Penunjuk ke string karakter yang dihentikan null konstan yang menentukan jalur ke gambar sistem operasi Windows tempat sarang registri berada. Gambar ini harus offline dan saat ini tidak di-boot kecuali parameter dwOptions berisi NETSETUP_PROVISION_ONLINE_CALLER dalam hal ini direktori sistem operasi yang berjalan secara lokal diizinkan.

Jalur ini bisa menjadi jalur UNC pada server jarak jauh.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan dapat menjadi salah satu kode kesalahan berikut atau salah satu kode kesalahan sistem.

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Akses ditolak. Kesalahan ini dikembalikan jika pemanggil tidak memiliki hak istimewa yang memadai untuk menyelesaikan operasi.
ERROR_ELEVATION_REQUIRED	Operasi yang diminta memerlukan elevasi.
ERROR_INVALID_PARAMETER	Parameter salah. Kesalahan ini dikembalikan jika parameter pProvisionBinData, cbProvisionBinDataSize, atau lpWindowsPathadalah NULL. Kesalahan ini juga dikembalikan jika buffer yang diacu oleh parameter pProvisionBinData tidak berisi data yang valid dalam blob untuk domain, nama akun mesin, atau kata sandi akun mesin. Kesalahan ini juga dikembalikan jika string yang menunjuk ke parameter lpWindowsPath tidak spesifik jalur ke citra sistem operasi Windows.
ERROR_NOT_SUPPORTED	Permintaan tidak didukung. Kesalahan ini dikembalikan jika server yang ditentukan tidak mendukung operasi ini. Misalnya, jika parameter lpWindowsPath mereferensikan penginstalan Windows yang dikonfigurasi sebagai pengendali domain.
NERR_WkstaNotStarted	Layanan Stasiun Kerja belum dimulai.

Keterangan

Fungsi NetRequestOfflineDomainJoin didukung pada Windows 7 untuk operasi gabungan domain offline.

Fungsi NetRequestOfflineDomainJoin digunakan secara lokal pada komputer untuk memodifikasi citra sistem operasi Windows yang dipasang pada volume. Registri dimuat untuk data blob gambar dan provisi ditulis di mana registri dapat diambil selama fase penyelesaian operasi gabungan domain offline. Skenario gabungan domain offline menggunakan fungsi-fungsi ini sebagai berikut:

NetProvisionComputerAccount adalah fungsi provisi yang pertama kali dipanggil untuk melakukan operasi jaringan yang diperlukan untuk membuat dan mengonfigurasi objek komputer di Direktori Aktif. Output dari NetProvisionComputerAccount adalah blob biner buram dari metadata berseri yang digunakan untuk langkah berikutnya.
NetRequestOfflineDomainJoin , fungsi inisialisasi gambar, kemudian dipanggil untuk menyuntikkan output dari fungsi provisi NetProvisionComputerAccount ke dalam gambar sistem operasi Windows yang akan digunakan selama penginstalan. Perubahan pada kode inisialisasi Windows akan mendeteksi status tersimpan ini dan memengaruhi bagian lokal saja dari gabungan domain.

Fungsi NetProvisionComputerAccount akan membuat atau menggunakan kembali akun komputer di domain, mengumpulkan semua metadata yang diperlukan dan mengembalikannya dalam blob biner versi buram atau sebagai teks untuk disematkan dalam file jawaban penyiapan tanpa pengawasan. Blob biner buram dapat dikonsumsi oleh operasi permintaan gabungan domain offline yang menyediakan semua input yang diperlukan untuk menyelesaikan gabungan domain selama boot pertama tanpa operasi jaringan apa pun (hanya pembaruan status lokal). Perhatikan bahwa blob berisi materi kata sandi akun mesin pada dasarnya dengan jelas. Desain tidak membuat ketentuan untuk mengamankan data ini. Masalah ini ada saat ini dengan file jawaban penyiapan tanpa pengawas yang dapat membawa sejumlah rahasia termasuk kata sandi pengguna domain. Pemanggil harus mengamankan blob dan file penyiapan yang tidak dijaga. Solusi untuk masalah ini bervariasi. Sebagai contoh, kunci pratukar dapat digunakan untuk mengenkripsi sesi antara konsumen dan entitas provisi yang memungkinkan transfer aman blob buram .

Blob buram yang dikembalikan dalam parameter pProvisionBinData oleh fungsi NetProvisionComputerAccount diberi versi untuk memungkinkan skenario interoperabilitas dan kemampuan layanan antara versi Windows yang berbeda (bergabung dengan klien, mesin provisi, dan pengontrol domain). Skenario gabungan offline saat ini tidak membatasi masa pakai blob yang dikembalikan oleh fungsi NetProvisionComputerAccount .

Untuk informasi selengkapnya tentang operasi gabungan domain offline, lihat Panduan Langkah demi Langkah Gabungan Domain Offline.

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	lmjoin.h (termasuk Lm.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll