DeleteNtmsRequests function (ntmsapi.h)
[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.
DWORD DeleteNtmsRequests(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpRequestId,
[in] DWORD dwType,
[in] DWORD dwCount
);
[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.
[in] dwCount
Number of requests in the list.
This function returns one of the following values.
Value | Meaning |
---|---|
|
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. |
|
Database is inaccessible or damaged. |
|
Database is full. |
|
The type identifier is not valid. |
|
The session handle is missing or is not valid. |
|
Memory allocation failure during processing. |
|
The function executed successfully. |
An error is not returned if a request or list of requests is not found.
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 |