Función DismountNtmsMedia (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 DismountNtmsMedia pone en cola un comando para mover el medio especificado en una unidad a su almacenamiento. Esta función debe emparejarse con la función MountNtmsMedia .

Sintaxis

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

Parámetros

[in] hSession

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

[in] lpMediaId

Matriz de al menos un medio lógico o lado.

[in] dwCount

Número de identificadores multimedia en el parámetro lpMediaId .

[in] dwOptions

Opciones. Este parámetro puede ser el siguiente valor.

Valor Significado
NTMS_DISMOUNT_DEFERRED
 Marca el estado multimedia como Desmontable y mantiene el medio en la unidad. Las solicitudes de montaje posteriores se satisfacen mediante unidades desmontadas o desmontables. El valor predeterminado es desmontar inmediatamente.
NTMS_DISMOUNT_IMMEDIATE
 Desmonte la unidad inmediatamente.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_USE_ACCESS al grupo de medios o a la biblioteca que contiene los medios se deniega. También se pueden producir otros errores de seguridad, pero indicarían un error del subsistema de seguridad.
ERROR_DATABASE_FAILURE
 La base de datos no es accesible o está dañada.
ERROR_DATABASE_FULL
 La base de datos está llena.
ERROR_DEVICE_NOT_AVAILABLE
 Uno o más recursos necesarios para realizar el desmontaje no están disponibles actualmente (probablemente deshabilitados).
ERROR_INVALID_LIBRARY
 La biblioteca que contiene el medio no es válida.
ERROR_INVALID_MEDIA
 Al menos uno de los medios especificados no es válido.
ERROR_INVALID_STATE
 Se produjo un estado de dispositivo o medio inesperado durante la desmontaje.
ERROR_MEDIA_OFFLINE
 El medio especificado está sin conexión.
ERROR_MEDIA_NOT_AVAILABLE
 Uno o varios recursos multimedia necesarios para realizar el montaje no están disponibles actualmente (probablemente deshabilitados).
ERROR_NOT_ENOUGH_MEMORY
 Error de asignación de memoria durante el procesamiento.
ERROR_SUCCESS
 El desmontaje de medios se ha puesto en cola.
ERROR_TIMEOUT
 El evento de tiempo de espera expiró mientras la aplicación intentaba adquirir uno o varios recursos.

Comentarios

Una aplicación debe usar la función DismountNtmsMedia para liberar el recurso de unidad después de que la aplicación haya usado el medio especificado. Otras sesiones de RSM no pueden usar medios noleas.

La función DismountNtmsMedia devuelve tan pronto como la operación se pone en cola con RSM. La aplicación puede esperar a que el estado lateral esté inactivo.

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

Funciones de Media Services

MountNtmsMedia