| Platform SDK: Removable Storage Manager |
The DeallocateNtmsMedia function deallocates the side associated with the specified logical media.
DWORD WINAPI DeallocateNtmsMedia( HANDLE hSession, LPNTMS_GUID lpMediaId, DWORD dwOptions );
| Value | Meaning |
|---|---|
| ERROR_ACCESS_DENIED | NTMS_MODIFY_ACCESS to media's media pool is denied. Other security errors are also possible, but they would indicate a security subsystem error. |
| ERROR_DATABASE_FAILURE | The database is inaccessible or damaged. |
| ERROR_DATABASE_FULL | The database is full. |
| ERROR_INVALID_HANDLE | The session handle is invalid or missing. |
| ERROR_INVALID_MEDIA | The LMID is invalid. |
| ERROR_INVALID_PARAMETER | The media or media pool ID is missing. |
| ERROR_INVALID_PARTITION | The LMID side is invalid. |
| ERROR_NOT_ENOUGH_MEMORY | An allocation failure occurred during processing. |
| ERROR_SUCCESS | The function was successful. |
When a logical medium is deallocated with the DeallocateNtmsMedia function, RSM puts the side associated with the logical media in the Available or Decommissioned media state. The logical media is deleted from the system when the logical media is deallocated.
Sides are decommissioned upon deallocation if the side has been allocated the maximum number of times specified in the media pool. After media is in the Decommissioned state, it cannot be allocated again.
Windows NT/2000: Requires Windows 2000.
Header: Declared in Ntmsapi.h.
Library: Use Ntmsapi.lib.