NTMS_LIBREQUESTINFORMATIONA Struktur (ntmsapi.h)

Artikel
11/20/2024

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

Die NTMS_LIBREQUESTINFORMATION-Struktur definiert die für eine Arbeitsanforderung spezifischen Eigenschaften, die an RSM in die Warteschlange gestellt werden.

Syntax

typedef struct _NTMS_LIBREQUESTINFORMATIONA {
  DWORD      OperationCode;
  DWORD      OperationOption;
  DWORD      State;
  NTMS_GUID  PartitionId;
  NTMS_GUID  DriveId;
  NTMS_GUID  PhysMediaId;
  NTMS_GUID  Library;
  NTMS_GUID  SlotId;
  SYSTEMTIME TimeQueued;
  SYSTEMTIME TimeCompleted;
  CHAR       szApplication[NTMS_APPLICATIONNAME_LENGTH];
  CHAR       szUser[NTMS_USERNAME_LENGTH];
  CHAR       szComputer[NTMS_COMPUTERNAME_LENGTH];
  DWORD      dwErrorCode;
  NTMS_GUID  WorkItemId;
  DWORD      dwPriority;
} NTMS_LIBREQUESTINFORMATIONA;

Angehörige

OperationCode

Elementvorgang. Dies kann einer der folgenden Werte sein:

Wert	Bedeutung
NTMS_LM_CLASSIFY	Klassifizieren Sie das Medium.
NTMS_LM_CLEANDRIVE	Bereinigen Eines Laufwerks.
NTMS_LM_DISABLELIBRARY	Deaktivieren Sie den Changer.
NTMS_LM_DISABLEDRIVE	Deaktivieren Sie ein Laufwerk.
NTMS_LM_DISABLEMEDIA	Deaktivieren Sie das Medium.
NTMS_LM_DISMOUNT	Aufheben der Bereitstellung des Mediums von einem Laufwerk.
NTMS_LM_DOORACCESS	Zugriff auf Medien über eine Bibliothekseinheitstür zulassen.
NTMS_LM_EJECT	Auswerfen des Mediums aus der Bibliothek.
NTMS_LM_EJECTCLEANER	Werfen Sie einen Sauberer aus.
NTMS_LM_ENABLELIBRARY	Aktivieren Sie den Changer.
NTMS_LM_ENABLEDRIVE	Aktivieren Sie ein Laufwerk.
NTMS_LM_ENABLEMEDIA	Aktivieren Sie das Medium.
NTMS_LM_INJECT	Fügen Sie das Medium in die Bibliothek ein.
NTMS_LM_INJECTCLEANER	Fügen Sie einen Reiniger ein.
NTMS_LM_INVENTORY	Führen Sie eine Bestandsaufnahme der Bibliothek aus.
NTMS_LM_MOUNT	Mount a side to a drive.
NTMS_LM_PROCESSOMID	Verarbeiten sie die OMID.
NTMS_LM_RELEASECLEANER	Lassen Sie einen saubereren Steckplatz frei.
NTMS_LM_REMOVE	Entfernen Sie eine Arbeitsaufgabe aus der Warteschlange.
NTMS_LM_RESERVECLEANER	Reservieren Sie einen saubereren Slot.
NTMS_LM_UPDATEOMID	Aktualisieren Sie die OMID.
NTMS_LM_WRITESCRATCH	Schreiben Sie eine kostenlose Bezeichnung.

OperationOption

Arbeitselementoptionen (Befehlsspezifisch).

State

Aktueller Status dieser Arbeitsaufgabe. Dies kann einer der folgenden Werte sein:

Wert	Bedeutung
NTMS_LM_QUEUED	Der Vorgang wird in die Warteschlange gestellt.
NTMS_LM_INPROCESS	Der Vorgang wird verarbeitet.
NTMS_LM_PASSED	Der Vorgang wurde erfolgreich abgeschlossen.
NTMS_LM_FAILED	Der Vorgang wurde mit einem Fehler abgeschlossen.
NTMS_LM_WAITING	Der Vorgang ist blockiert.
NTMS_LM_CANCELLED	Der Vorgang wurde abgebrochen.
NTMS_LM_INVALID	Der Vorgang ist ungültig.

PartitionId

Eindeutiger Bezeichner einer Seite, die gewartet wird.

DriveId

Eindeutiger Bezeichner eines Laufwerks, das gewartet wird.

PhysMediaId

Eindeutiger Bezeichner eines physischen Mediums, das gewartet wird.

Library

Bibliothek für diese Anforderung.

SlotId

Eindeutiger Bezeichner eines Steckplatzes des zu bedienenden physischen Mediums.

TimeQueued

Systemzeit, zu der diese Anforderung an RSM in die Warteschlange gestellt wurde.

TimeCompleted

Systemzeit, zu der diese Anforderung von RSM abgeschlossen wurde.

szApplication[NTMS_APPLICATIONNAME_LENGTH]

Anwendung, die die Operatoranforderung übermittelt hat.

szUser[NTMS_USERNAME_LENGTH]

Interaktiver Benutzer hat sich auf dem Computer angemeldet, der die Operatoranforderung übermittelt hat.

szComputer[NTMS_COMPUTERNAME_LENGTH]

Computer, der die Operatoranforderung übermittelt hat.

dwErrorCode

Fehlerrücklauf für Anforderungen, die mit status NTMS_LM_FAILED zurückgegeben werden. Dies ist ein Systemfehlercode.

WorkItemId

Zugeordnete Arbeitsaufgaben-ID für diese Anforderung. Dies wird derzeit verwendet, um die Arbeitsaufgaben-ID zu enthalten, die für eine NTMS_LM_REMOVE Anforderung abgebrochen werden soll.

dwPriority

Priorität der Arbeitsaufgabe.

Bemerkungen

Die NTMS_LIBREQUESTINFORMATION Struktur ist in der NTMS_OBJECTINFORMATION Struktur enthalten.

GUID in den Arbeitszeiten kann im Laufe der Zeit ungültig werden. Beispielsweise löscht ein Auswurf eines freien Mediums die PMID, nachdem die Medien ausgeworfen wurden. Die Arbeitsaufgabe wird jedoch nach Abschluss des Auswurfs nicht aktualisiert.

Anmerkung

Der ntmsapi.h-Header definiert NTMS_LIBREQUESTINFORMATION als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Header-	ntmsapi.h

Siehe auch

NTMS_OBJECTINFORMATION

Freigeben über