Función MoveToNtmsMediaPool (ntmsapi.h)

  • Artículo

[El Administrador de almacenamiento extraíble ya no está disponible a partir de Windows 7 y Windows Server 2008 R2.]

La función MoveToNtmsMediaPool mueve el medio especificado de su grupo de medios actual al grupo de medios especificado.

Sintaxis

DWORD MoveToNtmsMediaPool(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
  [in] LPNTMS_GUID lpPoolId
);

Parámetros

[in] hSession

Identificador de la sesión devuelta por la función OpenNtmsSession .

[in] lpMediaId

Identificador único de un elemento de medios físicos.

[in] lpPoolId

Identificador único del grupo de medios de destino.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_CONTROL_ACCESS al grupo de medios de comunicación se deniega. Otros errores de seguridad también son posibles, pero indicarían un error de subsistema de seguridad.

Windows XP: NTMS_MODIFY_ACCESS al grupo de medios de origen o al grupo de medios de destino se deniega. Otros errores de seguridad también son posibles, pero indicarían un error de subsistema de seguridad.
ERROR_BUSY
 Al menos un lado del medio está en uso o actualmente no está disponible.
ERROR_DATABASE_FAILURE
 La base de datos es inaccesible o está dañada.
ERROR_DATABASE_FULL
 La base de datos está llena.
ERROR_INVALID_HANDLE
 Falta el identificador de sesión o no es válido.
ERROR_INVALID_MEDIA_POOL
 El grupo de medios de destino no es válido; el grupo de medios no existe; o bien, los medios del grupo de importación o no reconocido solo se pueden mover al grupo gratuito.
ERROR_INVALID_MEDIA
 El medio de origen o el grupo de medios de origen implícito no es válido.
ERROR_INVALID_PARAMETER
 Falta el identificador de medios o el identificador del grupo de medios.
ERROR_MEDIA_INCOMPATIBLE
 El tipo de medio del origen difiere del tipo de medio del grupo de medios de destino.
ERROR_NOT_ENOUGH_MEMORY
 Error de asignación durante el procesamiento.
ERROR_SUCCESS
 La función se realizó correctamente.

Comentarios

El grupo de destino especificado en la función MoveToNtmsMediaPool debe ser del mismo tipo de medio y tener seguridad compatible.

RSM escribe un identificador en medios en los medios antes de mover los medios al grupo de medios libre.

Es posible que un medio que tenga una partición en el estado Completado, Asignado o Reservado no se mueva al grupo de medios gratis. Un medio se puede mover a un grupo de importación solo si todas las particiones del medio están en estado Import.

Windows Server 2003: Si el grupo gratuito es el grupo de origen, se requiere NTMS_USE_ACCESS al grupo gratuito y NTMS_CONTROL_ACCESS al grupo de destino. De lo contrario, se requiere NTMS_CONTROL_ACCESS en el grupo de origen y de destino. Si el grupo gratuito es el grupo de destino, se requiere NTMS_CONTROL_ACCESS al grupo de origen y NTMS_USER_ACCESS al grupo gratuito. De lo contrario, se requiere NTMS_CONTROL_ACCESS en los grupos de origen y de destino.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntmsapi.h
Library Ntmsapi.lib
Archivo DLL Ntmsapi.dll

Consulte también

AllocateNtmsMedia

CreateNtmsMediaPool

Funciones de Media Services