Platform SDK: Removable Storage Manager

DeleteNtmsRequest

The DeleteNtmsRequest 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.

DWORD WINAPI DeleteNtmsRequest(
  HANDLE hSession,
  LPNTMS_GUID lpRequestId,
  DWORD dwType,
  DWORD dwCount
);

Parameters

hSession: Handle to the session returned by the OpenNtmsSession function.
lpRequestId: List of NTMS_LIBREQUEST or NTMS_OPREQUEST identifiers to delete.
dwType: Either NTMS_LIBREQUESTINFORMATION or NTMS_OPREQUESTINFORMATION.
dwCount: Number of requests in the list.

Return Values

Value	Meaning
ERROR_SUCCESS	The function executed successfully.
ERROR_INVALID_PARAMETER	Invalid type identifier.
ERROR_INVALID_HANDLE	Bad or missing session handle.
ERROR_NOT_ENOUGH_MEMORY	Memory allocation failure during processing.
ERROR_DATABASE_FAILURE	Database is inaccessible or damaged.
ERROR_DATABASE_FULL	Database is full.
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS to the library is denied. Other security errors may have occurred, but these other security errors indicate a security subsystem error.

Remarks

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

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Ntmsapi.h.
  Library: Use Ntmsapi.lib.