Función GetNtmsObjectInformationA (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 GetNtmsObjectInformationA(
  [in]  HANDLE                    hSession,
  [in]  LPNTMS_GUID               lpObjectId,
  [out] LPNTMS_OBJECTINFORMATIONA 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 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 a su contenedor se deniega. También se pueden producir otros errores de seguridad, pero indicarían un error del 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 de 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 al equipo.
NTMS_COMPUTER Requiere NTMS_USE_ACCESS al equipo.
NTMS_DRIVE Requiere NTMS_USE_ACCESS a la biblioteca.
NTMS_DRIVE_TYPE Requiere NTMS_USE_ACCESS al 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 al equipo.
NTMS_OPREQUEST Requiere NTMS_USE_ACCESS al 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.
 

Nota

El encabezado ntmsapi.h define GetNtmsObjectInformation como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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