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

Sintaxis

DWORD DismountNtmsDrive(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpDriveId
);

Parámetros

[in] hSession

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

[in] lpDriveId

Identificador único de un objeto de unidad.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS a la biblioteca se deniega. También se pueden producir otros errores de seguridad, pero indicarían un error del subsistema de seguridad.

Windows XP: NTMS_CONTROL_ACCESS a la biblioteca 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
 La unidad o biblioteca no está habilitada.
ERROR_INVALID_DRIVE
 El identificador de unidad no es válido.
ERROR_INVALID_HANDLE
 Falta el identificador de sesión o no es válido.
ERROR_INVALID_LIBRARY
 La biblioteca de la unidad no es válida.
ERROR_INVALID_PARAMETER
 Falta el identificador de unidad.
ERROR_INVALID_STATE
 La unidad no contiene medios.
ERROR_NOT_ENOUGH_MEMORY
 Error de asignación durante el procesamiento.
ERROR_SUCCESS
 La función se realizó correctamente.

Comentarios

Si la unidad especificada por la función DismountNtmsDrive está vacía o si se abre el medio, se devuelve un error. De lo contrario, el medio se devuelve a su ranura.

Desmontar las solicitudes para unidades independientes colocan la unidad en estado desmontable y devuelven éxito.

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 control de biblioteca