Función GetNtmsObjectInformation (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 GetNtmsObjectInformation devuelve la estructura de información de un objeto para el objeto especificado.

Sintaxis

DWORD GetNtmsObjectInformation(
  [in]  HANDLE                   hSession,
  [in]  LPNTMS_GUID              lpObjectId,
  [out] LPNTMS_OBJECTINFORMATION lpInfo
);

Parámetros

[in] hSession

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

[in] lpObjectId

Identificador único del objeto RSM.

[out] lpInfo

Puntero a una estructura de NTMS_OBJECTINFORMATION que recibe la información del objeto.

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_USE_ACCESS al objeto o se deniega su contenedor. Otros errores de seguridad también son posibles, pero indicarían un error de subsistema de seguridad.

Windows XP: No se requieren derechos de acceso.
ERROR_INVALID_HANDLE
 Falta el identificador de sesión o no es válido.
ERROR_INVALID_PARAMETER
 Falta el identificador de objeto o la estructura de información, o el tamaño de la información del objeto o el tipo de objeto no es válido.
ERROR_NOT_ENOUGH_MEMORY
 Error de asignación durante el procesamiento.
ERROR_OBJECT_NOT_FOUND
 El identificador de objeto no es válido.
ERROR_SUCCESS
 La función se realizó correctamente.

Comentarios

El tamaño de la información y el tipo de la estructura de información deben establecerse correctamente en el parámetro lpInfo antes de usar la función GetNtmsObjectInformation .

Para evitar resultados impredecibles, las aplicaciones deben llamar a la función GetNtmsObjectInformation antes de llamar a la función SetNtmsObjectInformation . La función SetNtmsObjectInformation actualiza todos los miembros grabables de la estructura NTMS_OBJECTINFORMATION , por lo que la aplicación es responsable de proporcionar un valor para todos los miembros grabables.

A continuación se muestra la lista de objetos que requieren derechos de acceso especiales.

Object Access
NTMS_CHANGER Requiere NTMS_USE_ACCESS a la biblioteca.
NTMS_CHANGER_TYPE Requiere NTMS_USE_ACCESS en el equipo.
NTMS_COMPUTER Requiere NTMS_USE_ACCESS en el equipo.
NTMS_DRIVE Requiere NTMS_USE_ACCESS a la biblioteca.
NTMS_DRIVE_TYPE Requiere NTMS_USE_ACCESS en el equipo.
NTMS_IEDOOR Requiere NTMS_USE_ACCESS a la biblioteca.
NTMS_IEPORT Requiere NTMS_USE_ACCESS a la biblioteca.
NTMS_LIBRARY Requiere NTMS_USE_ACCESS a la biblioteca.
NTMS_LIBREQUEST Requiere NTMS_USE_ACCESS a la biblioteca.
NTMS_LOGICAL_MEDIA Requiere NTMS_USE_ACCESS al grupo de medios del medio lógico.
NTMS_MEDIA_TYPE Requiere NTMS_USE_ACCESS en el equipo.
NTMS_OPREQUEST Requiere NTMS_USE_ACCESS en el equipo.
NTMS_PARTITION Requiere NTMS_USE_ACCESS al grupo de medios del lado.
NTMS_PHYSICAL_MEDIA Requiere NTMS_USE_ACCESS al grupo de medios.
NTMS_STORAGESLOT Requiere NTMS_USE_ACCESS a la biblioteca.

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

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Funciones de administración de objetos

SetNtmsObjectInformation