IdentifyNtmsSlot-Funktion (ntmsapi.h)

  • Artikel

[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