SubmitNtmsOperatorRequestA-Funktion (ntmsapi.h)

Artikel
11/20/2024

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

Die SubmitNtmsOperatorRequest-Funktion sendet eine RSM-Operatoranforderung.

Syntax

DWORD SubmitNtmsOperatorRequestA(
  [in]  HANDLE      hSession,
  [in]  DWORD       dwRequest,
  [in]  LPCSTR      lpMessage,
  [in]  LPNTMS_GUID lpArg1Id,
  [in]  LPNTMS_GUID lpArg2Id,
  [out] LPNTMS_GUID lpRequestId
);

Parameter

[in] hSession

Behandeln Sie die sitzung, die von der OpenNtmsSession--Funktion zurückgegeben wird.

[in] dwRequest

Typ der Operatoranforderung. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
NTMS_OPREQ_CLEANER	RSM sendet eine Operatoranforderung, um einen Sauberer einzufügen, wenn ein sauberer Vorgang in die Warteschlange gestellt wird und kein Sauberer für das Laufwerk verfügbar ist. Der lpArg1Id Parameter kann eine Bibliotheks- oder Steckplatz-ID sein. Erfordert NTMS_CONTROL_ACCESS für die Bibliothek. Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_OPREQ_DEVICESERVICE	Eine Anwendung oder RSM sendet eine Operatoranforderung für den Laufwerksdienst, wenn ein Änderungsgerät oder Laufwerk Probleme hat. Der parameter lpArg1Id gibt das Gerät an, das Dienst benötigt. Dieser Parameter kann eine Iedoor, Bibliothek, physische Medien oder Laufwerk-ID sein. Erfordert NTMS_CONTROL_ACCESS für die Bibliothek. Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_OPREQ_MESSAGE	Nur Anwendungsnachricht. Erfordert NTMS_USE_ACCESS auf dem Computer. Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_OPREQ_MOVEMEDIA	Eine Anwendung oder RSM sendet eine Operatoranforderung zum Verschieben von Medien aus einer Bibliothek in eine andere für eine Bereitstellung von Offlinemedien oder das Auswerfen vorhandener Medien in die Offlinebibliothek. Der parameter lpArg1Id gibt den Teil physischer Medien an, der verschoben werden muss, und der parameter lpArg2Id die Zielbibliothek angibt. Erfordert NTMS_CONTROL_ACCESS für den Medienpool. Windows XP: Es sind keine Zugriffsrechte erforderlich.
NTMS_OPREQ_NEWMEDIA	Eine Anwendung oder RSM sendet eine Operatoranforderung für neue Medien, wenn keine Medien verfügbar sind. Der parameter lpArg1Id gibt das Medienpoolobjekt an und der parameter lpArg2Id ist der optionale Bibliotheksbezeichner, dem das neue Medium hinzugefügt werden soll. Erfordert NTMS_CONTROL_ACCESS für den Medienpool. Windows XP: Es sind keine Zugriffsrechte erforderlich.

[in] lpMessage

Optionale Nachrichtenzeichenfolge, die an den Benutzer gesendet werden soll.

[in] lpArg1Id

Objektbezeichner für die Operatoranforderung. In den Beschreibungen der Werte im dwRequest Parameter finden Sie eine Beschreibung des Typs des Objekts, der für diesen Parameter übergeben werden muss.

[in] lpArg2Id

Objektbezeichner für die Operatoranforderung. Ausführliche Informationen dazu, welcher Objekttyp für diesen Parameter übergeben werden muss, finden Sie in den Beschreibungen der Werte im dwRequest Parameter.

[out] lpRequestId

Zeigen Sie auf einen Puffer, der den Bezeichner der erstellten Operatoranforderung empfängt.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	Der Zugriff auf mindestens ein RSM-Objekt wird verweigert.
ERROR_DATABASE_FAILURE	Fehler bei der Datenbankabfrage oder Aktualisierung.
ERROR_INVALID_HANDLE	Der im hSession Parameter angegebene Wert ist NULL- oder ungültig.
ERROR_INVALID_PARAMETER	Einer der Parameterwerte ist ungültig.
ERROR_NOT_CONNECTED	Es kann keine Verbindung mit dem RSM-Dienst hergestellt werden.
ERROR_OBJECT_NOT_FOUND	Das Quell- oder Zielobjekt konnte nicht gefunden werden.
ERROR_SUCCESS	Die Funktion war erfolgreich.

Bemerkungen

Die SubmitNtmsOperatorRequest--Funktion sendet eine Operatoranforderung und gibt den Status der Anforderung (erfüllt oder abgebrochen) oder zeitüberschreitung zurück (wenn der Operator nicht auf die Anforderung reagiert). Operatoranforderungen werden verwendet, um Medien anzufordern, um anzufordern, dass das angegebene Medium von einer Bibliothek in eine andere verschoben wird, oder um den RSM-Gerätedienst anzufordern.

Der NTMS_OPEREQ_MESSAGE Wert (im dwRequest Parameter) ist der Anforderungstyp, der am häufigsten von Anwendungen verwendet wird. RSM kann NTMS_OPEREQ_MESSAGE nicht verwenden. RSM verwendet die anderen Anforderungstypen nach Bedarf.

Anmerkung

Der ntmsapi.h-Header definiert SubmitNtmsOperatorRequest 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]
Zielplattform-	Fenster
Header-	ntmsapi.h
Library	Ntmsapi.lib
DLL-	Ntmsapi.dll