Fungsi SetNtmsDeviceChangeDetection (ntmsapi.h)

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

Fungsi SetNtmsDeviceChangeDetection menetapkan satu atau beberapa perangkat target untuk deteksi perubahan.

Sintaks

DWORD SetNtmsDeviceChangeDetection(
  [in] HANDLE      hSession,
  [in] HANDLE      DetectHandle,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwType,
  [in] DWORD       dwCount
);

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .

[in] DetectHandle

Handel deteksi perubahan perangkat dari BeginNtmsDeviceChangeDetection, atau NULL untuk satu polling.

[in] lpRequestId

Pengidentifikasi objek untuk perangkat target. Parameter ini dapat berupa satu atau beberapa pustaka, jenis media, atau GUID media fisik. Semua GUID harus berjenis yang sama.

[in] dwType

Jenis pengidentifikasi objek yang ditentukan dalam parameter lpObjectId . Parameter ini dapat menjadi salah satu nilai berikut dari jenis enumerasi NtmsObjectsTypes : NTMS_LIBRARY, NTMS_MEDIA_TYPE, atau NTMS_PHYSICAL_MEDIA.

[in] dwCount

Jumlah pengidentifikasi objek dalam lpObjectId.

Nilai kembali

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai	Makna
ERROR_INVALID_HANDLE	Pegangan sesi atau deteksi tidak valid.
ERROR_INVALID_PARAMETER	Tipe objek tidak valid.
ERROR_INVALID_LIBRARY	Pustaka yang ditentukan tidak ditemukan.
ERROR_INVALID_MEDIA	Media atau tipe yang ditentukan tidak ditemukan.
ERROR_SUCCESS	Permintaan operator telah dibatalkan.

Keterangan

Perangkat dapat ditentukan langsung dengan meneruskan GUID pustaka atau secara tidak langsung dengan melewati media fisik atau GUID jenis media. Saat menggunakan spesifikasi tidak langsung, semua pustaka yang berdiri sendiri yang dapat berisi media atau jenis media terdeteksi. Semua perangkat yang ditentukan terus terdeteksi hingga handel deteksi perubahan perangkat ditutup menggunakan fungsi EndNtmsDeviceChangeDetection .

Fungsi ini juga dapat digunakan untuk melakukan polling untuk media yang diubah di perangkat yang ditentukan. Ini biasanya digunakan oleh UI saat membuka simpul daun atau menerapkan opsi refresh.

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

BeginNtmsDeviceChangeDetection

Ubah Fungsi Deteksi

EndNtmsDeviceChangeDetection