Fungsi CreateNtmsMediaPoolW (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.

Sintaksis

DWORD CreateNtmsMediaPoolW(
  [in]  HANDLE                hSession,
  [in]  LPCWSTR               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.

Nilai Arti
NTMS_OPEN_EXISTING
 Membuka kumpulan media yang ada berdasarkan nama. Mengembalikan ERROR_OBJECT_NOT_FOUND jika kumpulan tidak ada.
NTMS_OPEN_ALWAYS
 Membuka kumpulan media yang ada atau membuat kumpulan jika tidak ada.
NTMS_CREATE_NEW
 Membuat kumpulan media baru. Mengembalikan ERROR_ALREADY_EXISTS jika kumpulan ada.

[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.

Mengembalikan nilai

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai Arti
ERROR_ACCESS_DENIED
 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.
ERROR_ALREADY_EXISTS
 Tidak dapat membuat kumpulan media baru karena sudah ada dengan nama ini.
ERROR_DATABASE_FAILURE
 Database tidak dapat diakses atau rusak.
ERROR_DATABASE_FULL
 Database penuh. Kesalahan keamanan lainnya juga dimungkinkan, tetapi akan menunjukkan kesalahan subsistem keamanan.
ERROR_INVALID_HANDLE
 Handel sesi hilang atau tidak valid.
ERROR_INVALID_MEDIA
 Tipe media terpilih tidak valid.
ERROR_INVALID_NAME
 Sintaks nama kumpulan tidak valid. (Nama terlalu panjang.)
ERROR_INVALID_PARAMETER
 Nama kumpulan media atau penunjuk ID kumpulan media hilang.
ERROR_OBJECT_NOT_FOUND
 Tidak dapat membuka kumpulan media yang ada.
ERROR_SUCCESS
 Fungsi berhasil.

Komentar

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.

Nota

Header ntmsapi.h mendefinisikan CreateNtmsMediaPool sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

AllocateNtmsMedia

DeleteNtmsMediaPool

GetNtmsObjectSecurity

Media Services Functions

SetNtmsObjectSecurity

  • Last updated on