Fungsi CreateNtmsMediaA (ntmsapi.h)

[ Manajer Penyimpanan yang Dapat Dilepas tidak lagi tersedia pada Windows 7 dan Windows Server 2008 R2.]

Fungsi CreateNtmsMedia membuat PMID dan sisi (atau sisi) untuk bagian baru media offline. Media ditempatkan di kumpulan media yang ditentukan untuk lpPhysicalMedia.

Sintaksis

DWORD CreateNtmsMediaA(
  [in] HANDLE                    hSession,
  [in] LPNTMS_OBJECTINFORMATIONA lpMedia,
  [in] LPNTMS_OBJECTINFORMATIONA lpList,
  [in] DWORD                     dwOptions
);

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession.

[in] lpMedia

Penunjuk ke struktur NTMS_OBJECTINFORMATION yang berisi informasi tentang media yang akan dibuat. Untuk deskripsi anggota yang berlaku, lihat Komentar.

[in] lpList

Penunjuk ke struktur NTMS_OBJECTINFORMATION yang menentukan array sisi yang terkait dengan media. Untuk deskripsi anggota yang berlaku, lihat Komentar.

[in] dwOptions

Pilihan. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Arti
0	Nilai default. Memungkinkan pembuatan media duplikat dengan OMID duplikat.
NTMS_ERROR_ON_DUPLICATE	Mengembalikan kesalahan dan tidak membuat media jika media dengan OMID yang ditentukan sudah ada pada sistem.

Mengembalikan nilai

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai	Arti
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS ke komputer atau kumpulan media ditolak. Kesalahan keamanan lainnya dimungkinkan, tetapi menunjukkan kesalahan subsistem keamanan. Windows XP: NTMS_CONTROL_ACCESS ke kumpulan media atau NTMS_MODIFY_ACCESS ke pustaka offline ditolak. Kesalahan keamanan lainnya dimungkinkan, tetapi menunjukkan kesalahan subsistem keamanan.
ERROR_DATABASE_FAILURE	Database tidak dapat diakses atau rusak.
ERROR_DATABASE_FULL	Database penuh.
ERROR_DUPLICATE_OMID	Opsi NTMS_ERROR_ON_DUPLICATE disediakan dan media sudah ada dengan OMID ini.
ERROR_INVALID_HANDLE	Handel sesi hilang atau tidak valid.
ERROR_INVALID_MEDIA	Entri sudah ada untuk media dengan kode batang ini.
ERROR_INVALID_MEDIA_POOL	Kumpulan media yang ditentukan tidak ada, atau bukan kumpulan Impor atau Aplikasi yang valid.
ERROR_INVALID_PARAMETER	Parameter hilang, atau ukuran informasi objek atau jenis objek tidak valid.
ERROR_MEDIA_INCOMPATIBLE	Jumlah sisi yang ditentukan tidak cocok dengan jumlah sisi yang terkait dengan jenis media kumpulan media.
ERROR_NOT_ENOUGH_MEMORY	Kegagalan alokasi memori selama pemrosesan.
ERROR_SUCCESS	Fungsi berhasil dijalankan.

Komentar

Parameter lpMedia harus menunjuk ke struktur NTMS_OBJECTINFORMATION, yang parameter dwType NTMS_PHYSICAL_MEDIA. Berikut ini adalah daftar anggota dan deskripsi untuk struktur NTMS_OBJECTINFORMATION.

Anggota	Deskripsi
dwSize	[in] CreateNtmsMedia memverifikasi bahwa ukuran ini sama dengan panjang struktur NTMS_OBJECTINFORMATION yang berisi struktur NTMS_PMIDINFORMATION. Ini mengembalikan ERROR_INVALID_PARAMETER jika ukurannya salah.
dwType	[in] CreateNtmsMedia memverifikasi bahwa nilai NTMS_PHYSICAL_MEDIA disediakan. Ini mengembalikan ERROR_INVALID_PARAMETER jika jenis yang disediakan salah.
Dibuat	[out] Menunjukkan waktu objek media fisik dimasukkan ke dalam database NTMS.
yang Diubah	[out] Menunjukkan waktu objek media fisik dimasukkan ke dalam database NTMS.
ObjectGuid	[masuk/keluar] Pengidentifikasi unik untuk objek media fisik (PMID). Jika nilai NULL non-disediakan, nilai digunakan sebagai GUID Medium Fisik, jika tidak, GUID dihasilkan.
diaktifkan	[di] Menunjukkan apakah media fisik harus diaktifkan atau tidak.
dwOperationalState	[out] Pasti NTMS_READY.
szName	[in/out] CreateNtmsMedia memungkinkan aplikasi untuk menentukan nama media fisik baru. Ini memungkinkan aplikasi untuk terus menggunakan nama media setelah memindahkannya dari satu komputer RSM ke komputer RSM lainnya. Pilihan penamaan default RSM adalah: untuk satu sisi: Kode batang, lalu nilai Info Label atau Nomor Urutan;. untuk Barcode media multi-sisi, lalu Nomor Urutan. Perhatikan bahwa nama yang muncul di antarmuka pengguna RSM untuk partisi adalah nama ini (nama yang ditetapkan ke objek media fisik).
szDescription	[di] Parameter opsional yang dapat diatur menggunakan CreateNtmsMedia. Berikan string kosong ("\0") untuk menghindari meneruskan nilai untuk deskripsi.

Berikut ini adalah daftar anggota dan deskripsi untuk struktur NTMS_PMIDINFORMATION.

Anggota	Deskripsi
CurrentLibrary	[di] Harus berupa NULL_GUID, atau GUID pustaka Offline.
MediaPool	[di] Harus berupa GUID dari kumpulan Impor atau Aplikasi yang valid. CreateNtmsMedia memverifikasi bahwa ini adalah GUID dari Kumpulan Impor atau Aplikasi yang valid. Ini juga memverifikasi bahwa jumlah partisi yang disediakan sudah benar untuk jenis media yang terkait dengan kumpulan media ini.
Lokasi	[out] Pasti NULL_GUID.
LocationType	[out] Pasti NTMS_STORAGESLOT.
HomeSlot	[out] Pasti NULL_GUID.
MediaType	[out] CreateNtmsMedia mengatur jenis media ke jenis media yang terkait dengan kumpulan media yang disediakan.
szBarCode	[masuk/keluar] Kode batang dilucuti dari spasi akhir apa pun. CreateNtmsMedia tidak melakukan upaya tambahan untuk memverifikasi validitas kode batang.
BarCodeState	[out] BarCodeState diatur ke NTMS_BARCODESTATE_UNREADABLE jika nilai yang diteruskan untuk szBarCode adalah string kosong, jika tidak, nilai tersebut diatur ke NTMS_BARCODESTATE_OK.
szSequenceNumber	[out] CreateNtmsMedia menetapkan angka urutan yang baru dibuat, yang dikembalikan dalam anggota ini.
MediaState	[out] CreateNtmsMedia mengatur MediaState ke NTMS_MEDIASTATE_IDLE.
dwNumberOfPartitions	[di] Menentukan jumlah struktur NTMS_OBJECTINFORMATION yang mewakili sisi untuk media ini. pemeriksaan CreateNtmsMedia untuk memastikan bahwa jumlah sisi yang ditentukan cocok dengan jumlah sisi yang tersirat oleh kumpulan media yang akan ditetapkan. Jika tidak cocok, ERROR_MEDIA_INCOMPATIBLE dikembalikan.
dwMediaTypeCode	[di] Kode jenis media SCSI. Anggota ini tidak digunakan oleh RSM, tetapi dapat digunakan oleh aplikasi yang ditulis ke RSM untuk informasi tambahan tentang media. Untuk deskripsi tentang apa yang harus diatur anggota ini, lihat spesifikasi SCSI Produsen Perangkat Keras untuk pengaturan yang mungkin. RSM memperbarui anggota ini ketika memasang media yang baru diimpor untuk pertama kalinya.
dwDensityCode	[di] Kode kepadatan SCSI. Anggota ini tidak digunakan oleh RSM, tetapi dapat digunakan oleh aplikasi yang ditulis ke RSM untuk informasi tambahan tentang media. Untuk deskripsi tentang apa yang harus diatur anggota ini, lihat spesifikasi SCSI Produsen Perangkat Keras untuk pengaturan yang mungkin. RSM memperbarui anggota ini saat memasang media yang baru diimpor untuk pertama kalinya

Parameter lpList harus menunjuk ke struktur NTMS_OBJECTINFORMATION yang dwType NTMS_PARTITION dengan informasi berikut.

Anggota	Deskripsi
dwSize	[in] CreateNtmsMedia memverifikasi bahwa ukuran yang disediakan cocok dengan panjang struktur NTMS_OBJECTINFORMATION yang diharapkan yang berisi struktur NTMS_PARTITIONINFORMATION. Ini mengembalikan ERROR_INVALID_PARAMETER jika ukurannya salah.
dwType	[in] CreateNtmsMedia memverifikasi bahwa nilai NTMS_PARTITION disediakan. Ini mengembalikan ERROR_INVALID_PARAMETER jika jenis yang disediakan salah.
Dibuat	[out] Menunjukkan waktu objek partisi dimasukkan ke dalam database RSM.
yang Diubah	[out] Menunjukkan waktu objek partisi dimasukkan ke dalam database RSM.
ObjectGuid	[masuk/keluar] Pengidentifikasi unik untuk samping. Jika nilai NULL non-disediakan, nilai digunakan sebagai GUID sisi; jika tidak, GUID dihasilkan.
diaktifkan	[di] Menentukan apakah sisi harus diaktifkan atau tidak.
dwOperationalState	[out] Pasti NTMS_READY.
szName	[di] Nama sisi baru.
szDescription	[di] Parameter opsional yang dapat diatur menggunakan CreateNtmsMedia. Berikan string kosong ("\0") untuk menghindari meneruskan nilai untuk deskripsi.
PhysicalMedia	[out] GUID objek samping yang baru dibuat.
LogicalMedia	[masuk/keluar] Parameter input opsional, serta parameter output. Jika GUID disediakan, CreateNtmsMedia mencoba membuat objek media logis baru dengan GUID yang telah ditetapkan sebelumnya. Jika GUID tidak unik, CreateNtmsMedia mengembalikan kesalahan.
Status	[di] Status samping yang valid.
Sisi	[out] CreateNtmsMedia mengatur nomor samping ke offsetnya dalam array Partisi.
dwOmidLabelIdLength	[di] Harus berupa nilai positif. CreateNtmsMedia menggunakan dwOmidLabelIdLength untuk menentukan jumlah byte signifikan dalam anggota OmidLabelId. Jika nilai tidak benar, OmidLabelId yang direkam salah.
OmidLabelId	[di] Harus berupa label media yang valid yang dapat dikenali oleh MLL yang diinstal.
szOmidLabelType	[di] Tidak boleh berupa string kosong.
szOmidLabelInfo	[di] Mungkin string kosong.
dwMountCount	[di] Nilai apa pun diterima.
dwAllocateCount	[di] Nilai apa pun diterima.
Kapasitas	[di] Kode kapasitas SCSI. Anggota ini tidak digunakan oleh RSM, tetapi dapat digunakan oleh aplikasi yang ditulis ke RSM untuk informasi tambahan tentang media. Untuk deskripsi tentang apa yang harus diatur anggota ini, lihat spesifikasi SCSI Produsen Perangkat Keras untuk pengaturan yang mungkin. RSM memperbarui anggota ini ketika memasang media yang baru diimpor untuk pertama kalinya.

Nota

Header ntmsapi.h mendefinisikan CreateNtmsMedia sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	ntmsapi.h
Pustaka	Ntmsapi.lib
DLL	Ntmsapi.dll

Lihat juga

Media Services Functions

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2024-11-20