Edit

Share via

DeleteNtmsRequests function (ntmsapi.h)

  • Article

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

The DeleteNtmsRequests function deletes a request or a list of requests from the RSM database. Library or operator requests that are in a completed, failed, refused, or canceled state are removed. Submitted requests, queued requests, waiting requests, and in progress requests cannot be deleted.

Syntax

DWORD DeleteNtmsRequests(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwType,
  [in] DWORD       dwCount
);

Parameters

[in] hSession

Handle to the session returned by the OpenNtmsSession function.

[in] lpRequestId

List of identifiers of the library and operator requests to be deleted.

[in] dwType

Request type. This parameter can be one of the following values.

Value Meaning
NTMS_LIBREQUEST
 Library request.
NTMS_OPREQUEST
 Operator request.

[in] dwCount

Number of requests in the list.

Return value

This function returns one of the following values.

Value Meaning
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS to the computer is denied. Other security errors are also possible, but they would indicate a security subsystem error.

Windows XP:  NTMS_CONTROL_ACCESS to the computer is denied. Other security errors are also possible, but they would indicate a security subsystem error.
ERROR_DATABASE_FAILURE
 Database is inaccessible or damaged.
ERROR_DATABASE_FULL
 Database is full.
ERROR_INVALID_PARAMETER
 The type identifier is not valid.
ERROR_INVALID_HANDLE
 The session handle is missing or is not valid.
ERROR_NOT_ENOUGH_MEMORY
 Memory allocation failure during processing.
ERROR_SUCCESS
 The function executed successfully.

Remarks

An error is not returned if a request or list of requests is not found.

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

Library Control Functions