IClientVirtualDeviceSet2::CreateEx (VDI)

Berlaku untuk: SQL Server (semua versi yang didukung)

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 mengawali 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 Tutup, 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 ringkasan referensi antarmuka perangkat virtual SQL Server.