Función DeallocateNtmsMedia (ntmsapi.h)

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

La función DeallocateNtmsMedia desasigna el lado asociado a los medios lógicos especificados.

Sintaxis

DWORD DeallocateNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
       DWORD       dwOptions
);

Parámetros

[in] hSession

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

[in] lpMediaId

Identificador único del medio lógico (LMID).

dwOptions

Reservados; debe ser cero.

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 comunicación se deniega. Otros errores de seguridad también son posibles, pero indicarían un error de subsistema de seguridad.
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	El LMID no es válido.
ERROR_INVALID_PARAMETER	Falta el identificador del grupo de medios o multimedia.
ERROR_INVALID_PARTITION	El lado LMID no es válido.
ERROR_NOT_ENOUGH_MEMORY	Error de asignación durante el procesamiento.
ERROR_SUCCESS	La función se realizó correctamente.

Comentarios

Cuando se desasigna un medio lógico con la función DeallocateNtmsMedia , RSM coloca el lado asociado con los medios lógicos en el estado multimedia disponible o retirado. El medio lógico se elimina del sistema cuando se desasigna el medio lógico.

Los lados se retiran tras la desasignación si el lado se ha asignado el número máximo de veces especificados en el grupo de medios. Una vez que el medio está en estado retirado, no se puede volver a asignar.

Windows Server 2003: Si los medios se devuelven al grupo gratuito, se requiere NTMS_USE_ACCESS al grupo gratuito y NTMS_CONTROL_ACCESS al grupo de origen. Si el grupo gratuito no es el grupo de medios de destino, 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

Funciones de Media Services