NTMS_LIBREQUESTINFORMATIONW-Struktur (ntmsapi.h)

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

Die NTMS_LIBREQUESTINFORMATION-Struktur definiert die spezifischen Eigenschaften einer Arbeitsanforderung, die für RSM in die Warteschlange eingereiht werden.

Syntax

typedef struct _NTMS_LIBREQUESTINFORMATIONW {
  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;
  WCHAR      szApplication[NTMS_APPLICATIONNAME_LENGTH];
  WCHAR      szUser[NTMS_USERNAME_LENGTH];
  WCHAR      szComputer[NTMS_COMPUTERNAME_LENGTH];
  DWORD      dwErrorCode;
  NTMS_GUID  WorkItemId;
  DWORD      dwPriority;
} NTMS_LIBREQUESTINFORMATIONW;

Member

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	Heben Sie die Bereitstellung des Mediums von einem Laufwerk auf.
NTMS_LM_DOORACCESS	Erlauben Sie den Zugriff auf Medien über eine Bibliothekstür.
NTMS_LM_EJECT	Werfen Sie das Medium aus der Bibliothek aus.
NTMS_LM_EJECTCLEANER	Auswerfen eines Reinigers.
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 Cleaner ein.
NTMS_LM_INVENTORY	Führen Sie eine Bestandsaufnahme der Bibliothek durch.
NTMS_LM_MOUNT	Einbinden einer Seite an einem Laufwerk.
NTMS_LM_PROCESSOMID	Verarbeiten Sie die OMID.
NTMS_LM_RELEASECLEANER	Lassen Sie einen saubereren Slot frei.
NTMS_LM_REMOVE	Entfernen Sie ein Arbeitselement aus der Warteschlange.
NTMS_LM_RESERVECLEANER	Reservieren Sie einen saubereren Slot.
NTMS_LM_UPDATEOMID	Aktualisieren Sie die OMID.
NTMS_LM_WRITESCRATCH	Schreiben Sie eine freie Bezeichnung.

OperationOption

Arbeitselementoptionen (befehlsspezifisch).

State

Aktueller Status dieses Arbeitselements. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
NTMS_LM_QUEUED	Der Vorgang wird in eine Warteschlange gestellt.
NTMS_LM_INPROCESS	Der Vorgang wird verarbeitet.
NTMS_LM_PASSED	Operation 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 Slots des physischen Medienteils, das gewartet wird.

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 bei dem Computer angemeldet, der die Operatoranforderung übermittelt hat.

szComputer[NTMS_COMPUTERNAME_LENGTH]

Computer, der die Operatoranforderung übermittelt hat.

dwErrorCode

Fehlerrückgabe für Anforderungen, die den Status NTMS_LM_FAILED zurückgeben. Dies ist ein Systemfehlercode.

WorkItemId

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

dwPriority

Priorität des Arbeitselements.

Hinweise

Die NTMS_LIBREQUESTINFORMATION-Struktur ist in der NTMS_OBJECTINFORMATION-Struktur enthalten.

Die GUID in den Arbeitszeiten kann im Laufe der Zeit ungültig werden. Beispielsweise löscht ein Auswerfen eines freien Mediums die PMID, nachdem das Medium ausgeworfen wurde. Das Arbeitselement wird jedoch nach Abschluss des Auswurfs nicht aktualisiert.

Hinweis

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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	ntmsapi.h

Weitere Informationen

NTMS_OBJECTINFORMATION