Funzione SetNtmsDeviceChangeDetection (ntmsapi.h)

Articolo
03/13/2024

[Gestione archiviazione rimovibile non è più disponibile a partire da Windows 7 e Windows Server 2008 R2.]

La funzione SetNtmsDeviceChangeDetection imposta uno o più dispositivi di destinazione per il rilevamento delle modifiche.

Sintassi

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

Parametri

[in] hSession

Handle per la sessione restituita dalla funzione OpenNtmsSession .

[in] DetectHandle

Handle di rilevamento delle modifiche del dispositivo da BeginNtmsDeviceChangeDetection o NULL per un singolo polling.

[in] lpRequestId

Identificatore dell'oggetto per il dispositivo di destinazione. Questo parametro può essere uno o più GUID di libreria, supporti o supporti fisici. Tutti i GUID devono essere dello stesso tipo.

[in] dwType

Tipo di identificatori di oggetto specificati nel parametro lpObjectId . Questo parametro può essere uno dei valori seguenti del tipo di enumerazione NtmsObjectsTypes : NTMS_LIBRARY, NTMS_MEDIA_TYPE o NTMS_PHYSICAL_MEDIA.

[in] dwCount

Numero di identificatori di oggetto in lpObjectId.

Valore restituito

Questa funzione restituisce uno dei valori seguenti.

Valore	Significato
ERROR_INVALID_HANDLE	L'handle di sessione o rilevamento non è valido.
ERROR_INVALID_PARAMETER	Il tipo di oggetto non è valido.
ERROR_INVALID_LIBRARY	La libreria specificata non è stata trovata.
ERROR_INVALID_MEDIA	Impossibile trovare il supporto o il tipo specificato.
ERROR_SUCCESS	La richiesta dell'operatore è stata annullata.

Commenti

Il dispositivo può essere specificato direttamente passando GUID di libreria o indirettamente passando GUID di supporti fisici o di tipo di supporto. Quando si usa la specifica indiretta, vengono rilevate tutte le librerie autonome che potrebbero contenere il supporto o il tipo di supporto. Tutti i dispositivi specificati continuano a essere rilevati finché l'handle di rilevamento delle modifiche del dispositivo non viene chiuso usando la funzione EndNtmsDeviceChangeDetection .

Questa funzione può essere usata anche per eseguire il polling dei supporti modificati nei dispositivi specificati. Questa operazione viene in genere usata da un'interfaccia utente quando si apre un nodo foglia o si implementa un'opzione di aggiornamento.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ntmsapi.h
Libreria	Ntmsapi.lib
DLL	Ntmsapi.dll

Vedi anche

BeginNtmsDeviceChangeDetection

Funzioni di rilevamento delle modifiche

EndNtmsDeviceChangeDetection

Condividi tramite