UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:ntmsapi.MoveToNtmsMediaPool |
MoveToNtmsMediaPool function (ntmsapi.h) |
The MoveToNtmsMediaPool function moves the specified medium from its current media pool to the specified media pool. |
|
fs\movetontmsmediapool.htm |
fs |
6bc11877-6657-4e8b-8239-bb2720cfb256 |
12/05/2018 |
MoveToNtmsMediaPool, MoveToNtmsMediaPool function [Files], _zaw_movetontmsmediapool, base.movetontmsmediapool, fs.movetontmsmediapool, ntmsapi/MoveToNtmsMediaPool |
ntmsapi.h |
Windows |
Windows XP [desktop apps only] |
Windows Server 2003 [desktop apps only] |
Ntmsapi.lib |
Ntmsapi.dll |
Windows |
19H1 |
|
|
|
|
|
|
[Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.]
The MoveToNtmsMediaPool function moves the specified medium from its current media pool to the specified media pool.
Handle to the session returned by the OpenNtmsSession function.
Unique identifier of a piece of physical media.
Unique identifier of the destination media pool.
This function returns one of the following values.
Value | Meaning |
---|---|
|
NTMS_CONTROL_ACCESS to the media's media pool is denied. Other security errors are also possible, but they would indicate a security subsystem error.
Windows XP: NTMS_MODIFY_ACCESS to the source media's media pool or the destination media pool is denied. Other security errors are also possible, but they would indicate a security subsystem error. |
|
At least one side of the media is in use or currently unavailable. |
|
The database is inaccessible or damaged. |
|
The database is full. |
|
The session handle is missing or is not valid. |
|
The destination media pool is not valid; the media pool is nonexistent; or the media in the unrecognized or import pool may only be moved to the free pool. |
|
The source media or implied source media pool is not valid. |
|
The media ID or media pool ID is missing. |
|
The media type of the source differs from the media type of the destination media pool. |
|
An allocation failure occurred during processing. |
|
The function was successful. |
The destination pool specified in the MoveToNtmsMediaPool function must be of the same media type and have compatible security.
RSM writes an on-media identifier to media before moving the media into the free media pool.
A medium having a partition in the Completed, Allocated, or Reserved state may not be moved to the Free media pool. A medium may be moved to an Import pool only if all the partitions of the medium are in the Import state.
Windows Server 2003: If the free pool is the source pool, NTMS_USE_ACCESS to the free pool and NTMS_CONTROL_ACCESS to the destination pool is required. Otherwise, NTMS_CONTROL_ACCESS is required on both source and destination pool. If the free pool is the destination pool, NTMS_CONTROL_ACCESS to the source pool and NTMS_USER_ACCESS to the free pool is required. Otherwise, NTMS_CONTROL_ACCESS is required on both source and destination pools.