Compartir a través de

Función GetNtmsObjectInformationW (ntmsapi.h)

  • Artículo

[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 GetNtmsObjectInformationW(
  [in]  HANDLE                    hSession,
  [in]  LPNTMS_GUID               lpObjectId,
  [out] LPNTMS_OBJECTINFORMATIONW 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 siguientes valores.

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_USE_ACCESS al objeto o a su contenedor se deniega. Otros errores de seguridad también son posibles, 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.

Observaciones

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.

Objeto Acceso
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 Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de ntmsapi.h
biblioteca de Ntmsapi.lib
DLL de Ntmsapi.dll

Consulte también

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

funciones de administración de objetos de

SetNtmsObjectInformation