Función DisableNtmsObject (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 DisableNtmsObject deshabilita el objeto RSM especificado.

Sintaxis

DWORD DisableNtmsObject(
  [in] HANDLE      hSession,
  [in] DWORD       dwType,
  [in] LPNTMS_GUID lpObjectId
);

Parámetros

[in] hSession

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

[in] dwType

Tipo de objeto RSM. Este parámetro puede ser uno de los valores siguientes del tipo de enumeración NtmsObjectsTypes .

Valor Significado
NTMS_DRIVE
 Unidad
NTMS_LIBRARY
 Biblioteca
NTMS_PHYSICAL_MEDIA
 Medios físicos (cinta, disco óptico, CD o cartucho magnético)

[in] lpObjectId

Identificador único del objeto RSM.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS a la biblioteca que contiene el objeto se deniega. Otros errores de seguridad son posibles, pero indican un error del subsistema de seguridad.

Windows XP: NTMS_CONTROL_ACCESS a la biblioteca que contiene el objeto se deniega. Otros errores de seguridad son posibles, pero indican un error del subsistema de seguridad.
ERROR_DATABASE_FAILURE
 La base de datos no es accesible o está dañada.
ERROR_INVALID_HANDLE
 Falta el identificador de sesión o no es válido.
ERROR_INVALID_PARAMETER
 Falta un identificador de objeto o el tipo de objeto no es válido. (El tipo de objeto no es válido si no es NTMS_LIBRARY, NTMS_DRIVE o NTMS_PHYSICAL_MEDIA).
ERROR_INVALID_STATE
 El objeto ya está deshabilitado.
ERROR_LIBRARY_OFFLINE
 El identificador de biblioteca hace referencia a una biblioteca fuera de línea que no se puede habilitar o deshabilitar.
ERROR_OBJECT_NOT_FOUND
 El objeto no es válido.
ERROR_SUCCESS
 La deshabilitación se pone en cola.

Comentarios

La función DisableNtmsObject pone en cola un comando disable para el objeto especificado. La función devuelve correctamente cuando el comando se pone en cola. Si RSM está ocupado, el comando puede tardar algún tiempo en completarse. Cuando el medio está deshabilitado, RSM representa todos los lados del medio y los medios lógicos asociados no están disponibles. Todas las solicitudes a los errores de devolución de medios deshabilitados.

Para quitar una unidad o un modificador multimedia del servicio, primero debe deshabilitarse la unidad o el cambiador de medios.

Todos los objetos contenidos en un objeto deshabilitado también están deshabilitados. Por ejemplo, deshabilitar un elemento de medio físico deshabilita todos los lados. Siempre que sea posible, cuando se deshabilita una unidad, se quita el medio de la unidad y se coloca en su ranura.

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

EnableNtmsObject

Funciones de administración de objetos