SetNtmsDeviceChangeDetection-Funktion (ntmsapi.h)

Artikel
03/06/2024

[Wechselmedien-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]

Die SetNtmsDeviceChangeDetection-Funktion legt mindestens ein Zielgerät für die Änderungserkennung fest.

Syntax

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

Parameter

[in] hSession

Handle für die von der OpenNtmsSession-Funktion zurückgegebene Sitzung.

[in] DetectHandle

Das Erkennungshandle für Geräteänderungen von BeginNtmsDeviceChangeDetection oder NULL für eine einzelne Abfrage.

[in] lpRequestId

Objektbezeichner für das Zielgerät. Bei diesem Parameter kann es sich um eine oder mehrere Bibliotheks-, Medientyp- oder physische Medien-GUIDs handeln. Alle GUIDs müssen denselben Typ aufweisen.

[in] dwType

Typ der im lpObjectId-Parameter angegebenen Objektbezeichner. Dieser Parameter kann einer der folgenden Werte aus dem NtmsObjectsTypes-Enumerationstyp sein: NTMS_LIBRARY, NTMS_MEDIA_TYPE oder NTMS_PHYSICAL_MEDIA.

[in] dwCount

Anzahl der Objektbezeichner in lpObjectId.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_INVALID_HANDLE	Das Sitzungs- oder Erkennungshandle ist ungültig.
ERROR_INVALID_PARAMETER	Der Objekttyp ist ungültig.
ERROR_INVALID_LIBRARY	Die angegebene Bibliothek wurde nicht gefunden.
ERROR_INVALID_MEDIA	Das angegebene Medium oder der angegebene Typ wurde nicht gefunden.
ERROR_SUCCESS	Die Operatoranforderung wurde abgebrochen.

Hinweise

Das Gerät kann direkt durch Übergeben von Bibliotheks-GUIDs oder indirekt durch Übergeben physischer Medien oder Medientyp-GUIDs angegeben werden. Bei Verwendung der indirekten Spezifikation werden alle eigenständigen Bibliotheken erkannt, die den Medien- oder Medientyp enthalten können. Alle angegebenen Geräte werden weiterhin erkannt, bis das Erkennungshandle für Geräteänderungen mithilfe der EndNtmsDeviceChangeDetection-Funktion geschlossen wird.

Diese Funktion kann auch verwendet werden, um geänderte Medien auf den angegebenen Geräten abzufragen. Dies wird in der Regel von einer Benutzeroberfläche beim Öffnen eines Blattknotens oder beim Implementieren einer Aktualisierungsoption verwendet.

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

Weitere Informationen

BeginNtmsDeviceChangeDetection

Änderungserkennungsfunktionen

EndNtmsDeviceChangeDetection

Freigeben über