SatisfyNtmsOperatorRequest function (ntmsapi.h)

  • Article

[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(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId
);

Parameters

[in] hSession

Handle to the session returned by the OpenNtmsSession function.

[in] 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 a 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

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server 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