Fungsi DeallocateNtmsMedia (ntmsapi.h)

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

Fungsi DeallocateNtmsMedia membatalkan alokasi sisi yang terkait dengan media logis yang ditentukan.

Sintaks

DWORD DeallocateNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
       DWORD       dwOptions
);

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .

[in] lpMediaId

Pengidentifikasi unik media logis (LMID).

dwOptions

Dipesan; harus nol.

Nilai kembali

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai	Makna
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS ke kumpulan media ditolak. Kesalahan keamanan lainnya juga dimungkinkan, tetapi akan menunjukkan kesalahan subsistem keamanan. Windows XP: NTMS_MODIFY_ACCESS ke kumpulan media ditolak. Kesalahan keamanan lainnya juga dimungkinkan, tetapi akan menunjukkan kesalahan subsistem keamanan.
ERROR_DATABASE_FAILURE	Database tidak dapat diakses atau rusak.
ERROR_DATABASE_FULL	Database penuh.
ERROR_INVALID_HANDLE	Handel sesi hilang atau tidak valid.
ERROR_INVALID_MEDIA	LMID tidak valid.
ERROR_INVALID_PARAMETER	ID media atau kumpulan media hilang.
ERROR_INVALID_PARTITION	Sisi LMID tidak valid.
ERROR_NOT_ENOUGH_MEMORY	Kegagalan alokasi terjadi selama pemrosesan.
ERROR_SUCCESS	Fungsi berhasil.

Keterangan

Ketika media logis dibatalkan alokasinya dengan fungsi DeallocateNtmsMedia , RSM menempatkan sisi yang terkait dengan media logis dalam status media yang Tersedia atau Dinonaktifkan. Media logis dihapus dari sistem ketika media logis dibatalkan alokasinya.

Sisi dinonaktifkan setelah pembatalan alokasi jika sisi telah dialokasikan jumlah maksimum waktu yang ditentukan dalam kumpulan media. Setelah media dalam status Dinonaktifkan, media tidak dapat dialokasikan lagi.

Windows Server 2003: Jika media dikembalikan ke kumpulan gratis, NTMS_USE_ACCESS ke kumpulan gratis dan NTMS_CONTROL_ACCESS ke kumpulan sumber diperlukan. Jika kumpulan gratis bukan kumpulan media tujuan, NTMS_CONTROL_ACCESS diperlukan pada kumpulan sumber dan tujuan.

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

AlokasikanNtmsMedia

Fungsi Media Services