DeleteNtmsMediaPool function (ntmsapi.h)
[Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.]
The DeleteNtmsMediaPool function deletes the specified application media pool.
DWORD DeleteNtmsMediaPool( [in] HANDLE hSession, [in] LPNTMS_GUID lpPoolId );
Handle to the session returned by the OpenNtmsSession function.
Unique identifier of the media pool.
This function returns one of the following values.
NTMS_MODIFY_ACCESS to the media pool is denied. Other security errors are also possible, but they indicate a security subsystem error.
Windows XP: NTMS_CONTROL_ACCESS to the media pool is denied. Other security errors are also possible, but they indicate a security subsystem error.
||The database is inaccessible or damaged.|
||The session handle is missing or is not valid.|
||Unable to open existing media pool, or attempting to delete free, import, or unrecognized media pools.|
||The media pool ID is missing.|
||The media pool must be empty to be deleted.|
||An allocation failure occurred during processing.|
||The function was successful.|
Only empty media pools can be deleted with the DeleteNtmsMediaPool function.
Free, unrecognized, and import media pools are managed by RSM and cannot be deleted with DeleteNtmsMediaPool.
|Minimum supported client||Windows XP [desktop apps only]|
|Minimum supported server||Windows Server 2003 [desktop apps only]|