IdentifyNtmsSlot-Funktion (ntmsapi.h)

Artikel
03/13/2024

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

Die IdentifyNtmsSlot-Funktion identifiziert die Medien im angegebenen Slot in einer Bibliothek. Der Befehl gibt zurück, wenn die Identifizierung abgeschlossen ist.

Syntax

DWORD IdentifyNtmsSlot(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpSlotId,
  [in] DWORD       dwOption
);

Parameter

[in] hSession

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

[in] lpSlotId

Eindeutiger Bezeichner des zu identifizierenden Slotobjekts.

[in] dwOption

Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
NTMS_DISMOUNT_DEFERRED	Lassen Sie die Medien nach Abschluss der Medienidentifikation auf dem Laufwerk, als ob die Bereitstellung mit der Option "verzögert" aufgehoben worden wäre.
NTMS_DISMOUNT_IMMEDIATE	Heben Sie die Bereitstellung der Medien auf dem Laufwerk auf, nachdem die Medienidentifikation abgeschlossen ist.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	Der Zugriff auf ein oder mehrere RSM-Objekte wird verweigert.
ERROR_INVALID_HANDLE	Der im hSession-Parameter angegebene Wert ist ungültig.
ERROR_INVALID_PARAMETER	Die Slot-ID oder dwOption ist ungültig.
ERROR_SUCCESS	Die Funktion war erfolgreich.

Hinweise

Wenn der Slot leer ist, gibt die Funktion ERROR_SUCCESS zurück, aber es werden keine neuen Mediendatensätze angezeigt.

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

InventoryNtmsLibrary

Bibliothekssteuerungsfunktionen

Freigeben über