DeleteNtmsMediaType function (ntmsapi.h)
[Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.]
The DeleteNtmsMediaType function deletes the specified media type relation from the specified library, provided that the library does not contain any physical media objects of the specified media type.
Syntax
DWORD DeleteNtmsMediaType(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpMediaTypeId,
[in] LPNTMS_GUID lpLibId
);
Parameters
[in] hSession
Handle to the session returned by the OpenNtmsSession function.
[in] lpMediaTypeId
Unique identifier of a media type to delete from a library.
[in] lpLibId
Unique identifier of the library from which to delete the media type.
Return value
This function returns one of the following values.
| Value | Meaning |
|---|---|
|
NTMS_MODIFY_ACCESS to the library is denied. Other security errors are possible, but indicate a security subsystem error.
Windows XP: NTMS_CONTROL_ACCESS to the library is denied. Other security errors are possible, but indicate a security subsystem error. |
|
The database is inaccessible or damaged. |
|
The database is full. |
|
The session handle is missing or is not valid. |
|
The library ID is not valid. |
|
The media type or library ID is missing. |
|
An allocation failure occurred during processing. |
|
The function was successful. |
Remarks
If there are no physical media objects of the specified media type in the RSM system and there are no library objects that contain the specified media type relation in the RSM system, the system media pools for that media type will be deleted. Inability to delete the system media pools does not cause the DeleteNtmsMediaType function to fail.
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 |