Fungsi CreateNtmsMediaPool (ntmsapi.h)
[Manajer Penyimpanan yang Dapat Dilepas tidak lagi tersedia pada Windows 7 dan Windows Server 2008 R2.]
Fungsi CreateNtmsMediaPool membuat kumpulan media aplikasi baru.
Sintaks
DWORD CreateNtmsMediaPool(
[in] HANDLE hSession,
[in] LPCTSTR lpPoolName,
[in] LPNTMS_GUID lpMediaType,
[in] DWORD dwAction,
[in] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
[out] LPNTMS_GUID lpPoolId
);
Parameter
[in] hSession
Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .
[in] lpPoolName
Nama kumpulan media baru. Nama kumpulan media harus unik dalam cakupan database RSM tunggal.
[in] lpMediaType
Pengidentifikasi untuk jenis media dalam kumpulan media ini. Gunakan fungsi EnumerateNtmsObject untuk mendapatkan daftar jenis media yang tersedia dan atributnya. Aplikasi dapat meneruskan penunjuk NULL untuk membuat kumpulan media yang hanya berisi kumpulan media lainnya.
[in] dwAction
Tindakan yang harus dilakukan. Parameter ini harus menjadi salah satu nilai berikut.
[in] lpSecurityAttributes
Deskriptor keamanan opsional yang digunakan untuk membatasi akses ke kumpulan.
[out] lpPoolId
Penunjuk ke variabel yang menerima pengidentifikasi unik kumpulan media setelah kumpulan media berhasil dibuat atau dibuka.
Nilai kembali
Fungsi ini mengembalikan salah satu nilai berikut.
Nilai | Makna |
---|---|
|
NTMS_CONTROL_ACCESS ke kumpulan akar atau kumpulan media induk ditolak saat mencoba membuat kumpulan media baru. Kesalahan keamanan lainnya juga dimungkinkan, tetapi akan menunjukkan kesalahan subsistem keamanan.
Windows XP: NTMS_MODIFY_ACCESS ke kumpulan media induk ditolak saat mencoba membuat kumpulan media baru. Kesalahan keamanan lainnya juga dimungkinkan, tetapi akan menunjukkan kesalahan subsistem keamanan. |
|
Tidak dapat membuat kumpulan media baru karena sudah ada dengan nama ini. |
|
Database tidak dapat diakses atau rusak. |
|
Database penuh. Kesalahan keamanan lainnya juga dimungkinkan, tetapi akan menunjukkan kesalahan subsistem keamanan. |
|
Handel sesi hilang atau tidak valid. |
|
Tipe media yang dipilih tidak valid. |
|
Sintaks nama kumpulan tidak valid. (Nama terlalu panjang.) |
|
Nama kumpulan media atau penunjuk ID kumpulan media hilang. |
|
Tidak dapat membuka kumpulan media yang ada. |
|
Fungsi berhasil. |
Keterangan
Kumpulan media Gratis, Tidak Dikenal, dan Impor dibuat oleh RSM dan tidak dapat dibuat dengan fungsi CreateNtmsMediaPool .
Kumpulan media RSM diatur sebagai hierarki yang dipisahkan oleh karakter "". Kumpulan media Aplikasi, Gratis, Tidak Dikenal, dan Impor ada di akar hierarki. RSM membuat dan mengelola kumpulan Gratis, Tidak Dikenal, dan Impor. RSM membuat kumpulan media Gratis untuk setiap jenis media yang tersedia.
Kumpulan media khusus aplikasi dibuat oleh aplikasi. Aplikasi membuat kumpulan media untuk penggunaannya sendiri di bawah kumpulan aplikasi akar. Kumpulan media ini memiliki nama seperti sistem file. Hanya titik akhir nama yang berisi media dan kebijakan. Aplikasi dapat menentukan kumpulan seperti \MyApp\Pool1 dan \MyApp\Pool2. Ini menyampaikan hierarki ke antarmuka pengguna dan menghindari nama duplikat. Setiap tingkat kumpulan harus dibuat satu per satu; pertama MyApp dan kemudian Pool1 dan Pool2, seperti folder dan file.
Windows Server 2003: Untuk membuat kumpulan media, Anda harus memiliki NTMS_CONTROL_ACCESS ke kumpulan akar dan kumpulan induk. Jika deskriptor keamanan tidak disediakan, kumpulan mewarisi ACE dari kumpulan induknya (jika kumpulan induk bukan kumpulan akar). Selain itu, pembuat dan akun sistem lokal memiliki akses penuh ke kumpulan. Jika kumpulan induk adalah kumpulan akar, ACE-nya tidak diwariskan; satu-satunya ACE di DACL adalah akses penuh untuk pembuat dan akun sistem lokal.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | ntmsapi.h |
Pustaka | Ntmsapi.lib |
DLL | Ntmsapi.dll |
Lihat juga
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