Función EnableNtmsObject (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 EnableNtmsObject habilita el objeto especificado.

Sintaxis

DWORD EnableNtmsObject(
  [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 de disco 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 de 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 de subsistema de seguridad.

ERROR_DATABASE_FAILURE
La base de datos es inaccesible o está dañada.
ERROR_INVALID_HANDLE
Falta el identificador de sesión o no es válido.
ERROR_INVALID_PARAMETER
Falta el 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á habilitado.
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 habilitación está en cola.

Comentarios

La función EnableNtmsObject pone en cola un comando disable con RSM. Si RSM está ocupado, el comando puede tardar algún tiempo en completarse.

Requisitos

   
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

DisableNtmsObject

Funciones de administración de objetos