Fungsi SwapNtmsMedia (ntmsapi.h)

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

Fungsi SwapNtmsMedia menukar sisi yang terkait dengan dua LMID yang ditentukan. LMID yang ditentukan harus berada di kumpulan media yang sama.

Sintaks

DWORD SwapNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId1,
  [in] LPNTMS_GUID lpMediaId2
);

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .

[in] lpMediaId1

Pengidentifikasi unik dari sepotong media logis (LMID).

[in] lpMediaId2

Pengidentifikasi unik dari sepotong media logis (LMID).

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai	Makna
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS ke kumpulan media ditolak. Kesalahan keamanan lainnya juga dimungkinkan, tetapi akan menunjukkan kesalahan subsistem keamanan.
ERROR_BAD_FORMAT	Tidak ada pustaka label media yang mengenali label media.
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	Setidaknya salah satu ID media tidak valid.
ERROR_INVALID_MEDIA_POOL	Satu atau beberapa kumpulan media untuk media logika tidak valid.
ERROR_INVALID_PARAMETER	Setidaknya satu pengidentifikasi media hilang.
ERROR_NOT_ENOUGH_MEMORY	Kegagalan alokasi terjadi selama pemrosesan.
ERROR_SUCCESS	Fungsi berhasil.

Fungsi SwapNtmsMedia digunakan untuk memperbarui media fisik tanpa memengaruhi aplikasi.

Media untuk kedua LMID tidak boleh digunakan agar fungsi ini berhasil.

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