BeginNtmsDeviceChangeDetection-Funktion (ntmsapi.h)
[Wechselmedien-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]
Mit der Funktion BeginNtmsDeviceChangeDetection kann die Anwendung eine Sitzung zur Erkennung von Geräteänderungen starten.
Syntax
DWORD BeginNtmsDeviceChangeDetection(
[in] HANDLE hSession,
[out] LPHANDLE lpDetectHandle
);
Parameter
[in] hSession
Handle für die von der OpenNtmsSession-Funktion zurückgegebene Sitzung.
[out] lpDetectHandle
Zeiger auf die Variable, die das Erkennungshandle für Geräteänderungen empfängt.
Rückgabewert
Diese Funktion gibt einen der folgenden Werte zurück.
| Wert | Bedeutung |
|---|---|
|
Der Wert des hSession-Parameters ist kein gültiges Sitzungshandle. |
|
Die Operatoranforderung wurde abgebrochen. |
Hinweise
Nach dem Aufruf von BeginNtmsDeviceChangeDetection kann die Anwendung mithilfe der SetNtmsDeviceChangeDetection-Funktion die eigenständigen Bibliotheken festlegen, für die die Erkennung von Medienänderungen erforderlich ist. Der Wechselspeicher-Manager erkennt weiterhin Änderungen für die angegebenen Geräte, bis die Änderungserkennungssitzung mit der EndNtmsDeviceChangeDetection-Funktion geschlossen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ntmsapi.h |
| Bibliothek | Ntmsapi.lib |
| DLL | Ntmsapi.dll |