Share via


CancelNtmsOperatorRequest-Funktion (ntmsapi.h)

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

Die CancelNtmsOperatorRequest-Funktion bricht die angegebene RSM-Operatoranforderung ab.

Syntax

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

Parameter

[in] hSession

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

[in] lpRequestId

Eindeutiger Bezeichner der Operatoranforderung, die abgebrochen werden soll.

Verwenden Sie die Funktion EnumerateNtmsObject , um die Liste der vorhandenen Operatoranforderungen abzurufen. Sie können auch den von der SubmitNtmsOperatorRequest-Funktion zurückgegebenen Bezeichner verwenden.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert Bedeutung
ERROR_ACCESS_DENIED
Der Benutzer, der versucht hat, diese Funktion auszuführen, verfügt nicht über Administratorrechte. Nur ein Administrator des RSM-Servers kann Operatoranforderungen abbrechen.
ERROR_INVALID_HANDLE
Das Sitzungshandle fehlt oder ist ungültig.
ERROR_INVALID_PARAMETER
Der Anforderungsbezeichner fehlt.
ERROR_INVALID_STATE
Die Anforderung wurde bereits abgeschlossen oder abgebrochen.
ERROR_OBJECT_NOT_FOUND
Die Id des Operatoranforderungsobjekts wurde nicht gefunden. Dieser Fehler kann auftreten, wenn die Anforderungs-ID ungültig ist.
ERROR_SUCCESS
Die Operatoranforderung wurde abgebrochen.

Anforderungen

   
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

Operator Request Functions

SatisfyNtmsOperatorRequest

SubmitNtmsOperatorRequest