WaitForNtmsOperatorRequest-Funktion (ntmsapi.h)

Artikel
08/25/2023

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

Die WaitForNtmsOperatorRequest-Funktion wartet auf die angegebene RSM-Operatoranforderung.

Syntax

DWORD WaitForNtmsOperatorRequest(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwTimeout
);

Parameter

[in] hSession

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

[in] lpRequestId

Operatoranforderungsbezeichner, der von der SubmitNtmsOperatorRequest-Funktion erstellt wurde.

[in] dwTimeout

Anzahl der zu wartenden Millisekunden. Um nach einer Operatoranforderung zu suchen, übergeben Sie einen Timeoutwert von 0. Wenn Sie den Wert INFINITE angeben, tritt für diese Funktion kein Timeout auf.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_CANCELLED	Die Operatoranforderung wurde von einem Administrator abgebrochen.
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 Operatoranforderungsobjekt konnte nicht gefunden werden. Objektanforderungen werden aus der Datenbank geleert. Die Anwendung sollte eine Funktion wie AllocateNtmsMedia aufrufen, wenn RSM diesen Fehler zurückgibt.
ERROR_SUCCESS	Die Funktion war erfolgreich.
ERROR_TIMEOUT	Die im dwTimeout-Parameter angegebene Zeit ist vor abschluss der Operatoranforderung verstrichen.

Hinweise

Operatoranforderungen, die mit der WaitForNtmsOperatorRequest-Funktion angegeben sind, werden verwendet, um Medien anzufordern, das Medium von einer Bibliothek in eine andere zu verschieben, oder um den RSM-Gerätedienst anzufordern.

Eine Anwendung wartet mithilfe von WaitForNtmsOperatorRequest auf die Auflösung einer Operatoranforderung. Die Anforderung kann erfüllt, abgelehnt, gelöscht oder zeitlimitiert werden.

In der Regel verwenden Anwendungen die SubmitNtmsOperatorRequest-Funktion , um Operatoranforderungen zu übermitteln, und verwenden die WaitForNtmsOperatorRequest-Funktion , um auf ihre Auflösung zu warten.

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

CancelNtmsOperatorRequest

Operator Request Functions

SatisfyNtmsOperatorRequest

SubmitNtmsOperatorRequest

Freigeben über