SatisfyNtmsOperatorRequest function (ntmsapi.h)

Article
02/22/2024

[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