IClientVirtualDeviceSet2::CreateEx (VDI)
Berlaku untuk:SQL Server
Fungsi CreateEx membuat set perangkat virtual.
Sintaks
HRESULT IClientVirtualDeviceSet2::CreateEx (
LPCWSTR lpInstanceName,
LPCWSTR lpName,
VDConfig* pCfg
);
Parameter
lpInstanceName String ini mengidentifikasi instans SQL Server tempat perintah SQL akan dikirim.
lpName Ini mengidentifikasi set perangkat virtual. Aturan untuk nama yang digunakan oleh CreateFileMapping() harus diikuti. Karakter apa pun kecuali garis miring terbalik () dapat digunakan. Ini adalah string Unicode berkarakter lebar. Disarankan untuk memberi awalan string dengan nama produk atau perusahaan dan nama database pengguna.
pCfg Ini adalah konfigurasi untuk set perangkat virtual. Untuk informasi lebih lanjut, lihat Konfigurasi.
Tampilkan Nilai
Tampilkan Nilai | Penjelasan |
---|---|
NOERROR | Fungsi berhasil. |
VD_E_NOTSUPPORTED | Satu atau beberapa bidang dalam konfigurasi tidak valid atau tidak didukung. |
VD_E_PROTOCOL | Set perangkat virtual telah dibuat. |
Keterangan
Metode CreateEx harus dipanggil hanya sekali per operasi BACKUP atau RESTORE. Setelah memanggil metode Close, klien dapat menggunakan kembali antarmuka untuk membuat set perangkat virtual lain.
Nama instans harus mengidentifikasi instans tempat Transact-SQL dikeluarkan. NULL mengidentifikasi instans default. Tidak ada awalan "machineName" yang diterima.
Panggilan CreateEx (dan Buat) akan memodifikasi DACL keamanan pada handel proses dalam proses klien. Karena itu, modifikasi lain dari handel proses harus diserialisasikan dengan pemanggilan CreateEx. CreateEx akan diserialisasikan dengan panggilan lain ke CreateEx, tetapi tidak dapat diserialisasikan dengan pemrosesan eksternal. Akses diberikan ke akun yang menjalankan layanan SQL Server.
Metode CreateEx menggantikan metode Buat yang ditentukan dalam IClientVirtualDeviceSet asli. Metode Buat asli tidak digunakan lagi dan tidak boleh digunakan dalam pengembangan di masa mendatang. Metode Buat asli mengimplementasikan bentuk dukungan nama instans dengan variabel lingkungan VIRTUAL_SERVER_NAME . Jika variabel tersebut diatur di lingkungan, maka metode Buat secara internal memanggil CreateEx, meneruskan nilai VIRTUAL_SERVER_NAME sebagai nama instans.
Langkah berikutnya
Untuk informasi selengkapnya, lihat gambaran umum referensi antarmuka perangkat virtual SQL Server.
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk