SatisfyNtmsOperatorRequest function

[Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.]

The SatisfyNtmsOperatorRequest function completes the specified RSM operator request.

Syntax

DWORD SatisfyNtmsOperatorRequest(
  HANDLE      hSession,
  LPNTMS_GUID lpRequestId
);

Parameters

hSession

Handle to the session returned by the OpenNtmsSession function.

lpRequestId

Operator request object ID. This value is returned by SubmitNtmsOperatorRequest.

Return Value

This function returns one of the following values.

Value Meaning
ERROR_ACCESS_DENIED
The user that tried to execute this function does not have administrator privileges. Only an administrator of the RSM server can satisfy operator requests.
ERROR_OBJECT_NOT_FOUND
The operator request object ID was not found. This error occurs if the request is completed before the operation has been satisfied or when an request ID that is not valid is specified.
ERROR_SUCCESS
The operator request has been satisfied.

Remarks

If an application detects that the operator did not acknowledge a satisfied operator request, the application can use the SatisfyNtmsOperatorRequest function to remove the request.

For a list of the existing operator requests to cancel with the SatisfyNtmsOperatorRequest function, see the EnumerateNtmsObject function.

Requirements

   
Windows version Windows XP [desktop apps only] Windows Server 2003 [desktop apps only]
Target Platform Windows
Header ntmsapi.h
Library Ntmsapi.lib
DLL Ntmsapi.dll

See Also

CancelNtmsOperatorRequest

Operator Request Functions

SubmitNtmsOperatorRequest

WaitForNtmsOperatorRequest