WaitForNtmsOperatorRequest-Funktion (ntmsapi.h)

  • Artikel

[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