Fungsi NetRequestOfflineDomainJoin (lmjoin.h)
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 .
[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 |
|---|---|
|
Akses ditolak. Kesalahan ini dikembalikan jika pemanggil tidak memiliki hak istimewa yang memadai untuk menyelesaikan operasi. |
|
Operasi yang diminta memerlukan elevasi. |
|
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. |
|
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. |
|
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 |
Lihat juga
NetRequestProvisioningPackageInstall