[Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.]
The SubmitNtmsOperatorRequest function submits an RSM operator request.
DWORD SubmitNtmsOperatorRequestA( HANDLE hSession, DWORD dwRequest, LPCSTR lpMessage, LPNTMS_GUID lpArg1Id, LPNTMS_GUID lpArg2Id, LPNTMS_GUID lpRequestId );
Handle to the session returned by the OpenNtmsSession function.
Type of operator request. This parameter can be one of the following values.
Optional message string to be sent to the user.
Object identifier for the operator request. Refer to the descriptions of the values in the dwRequest parameter for a description of what type of object must be passed for this parameter.
Object identifier for the operator request. Refer to the descriptions of the values in the dwRequest parameter for details on what type of object must be passed for this parameter.
Pointer to a buffer that receives the identifier of the operator request that was created.
This function returns one of the following values.
||Access to one or more RSM objects is denied.|
||The database query or update failed.|
||The value specified in the hSession parameter is NULL or is not valid.|
||One of the parameter values is not valid.|
||Unable to connect to the RSM service.|
||Unable to find the source or destination object.|
||The function was successful.|
The SubmitNtmsOperatorRequest function submits an operator request and returns the status of the request (Satisfied or Canceled) or times out (if the operator does not act upon the request). Operator requests are used to request media, to request that the specified medium be moved from one library to another, or to request RSM device service.
The NTMS_OPEREQ_MESSAGE value (in the dwRequest parameter) is the request type most often used by applications. RSM cannot use NTMS_OPEREQ_MESSAGE. RSM uses the other request types as needed.
|Windows version||Windows XP [desktop apps only] Windows Server 2003 [desktop apps only]|