Compartir a través de

Función GetNtmsObjectAttributeW (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 GetNtmsObjectAttribute recupera el atributo extendido (datos privados con nombre) del objeto RSM especificado.

Sintaxis

DWORD GetNtmsObjectAttributeW(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpObjectId,
  [in]      DWORD       dwType,
  [in]      LPCWSTR     lpAttributeName,
  [out]     LPVOID      lpAttributeData,
  [in, out] LPDWORD     lpAttributeSize
);

Parámetros

[in] hSession

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

[in] lpObjectId

Identificador único del objeto desde el que se van a recuperar los datos.

[in] dwType

Tipo de objeto RSM. Para obtener una lista de tipos de objeto, vea NtmsObjectsTypes.

[in] lpAttributeName

Nombre del atributo extendido cuyos datos se van a recuperar.

[out] lpAttributeData

Puntero al búfer que recibe los datos.

[in, out] lpAttributeSize

Tamaño del búfer de datos en la entrada, en bytes. En la salida, el tamaño real de los datos, en bytes.

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_DATABASE_FAILURE
 Error en la consulta o actualización de la base de datos.
ERROR_INSUFFICIENT_BUFFER
 El tamaño del búfer no se especifica correctamente. El tamaño correcto se devuelve en el parámetro lpAttributeSize.
ERROR_INVALID_HANDLE
 El valor especificado en el parámetro hSession es NULL o no es válido.
ERROR_INVALID_PARAMETER
 El puntero es NULL o no es válido.
ERROR_NOT_CONNECTED
 No se puede conectar al servicio RSM.
ERROR_OBJECT_NOT_FOUND
 No se encontró el atributo especificado.
ERROR_SUCCESS
 La función se realizó correctamente.

Observaciones

La función getNtmsObjectAttribute debe ejecutarse en el servidor RSM. Dado que el búfer de bytes no está registrado entre sistemas de diferentes arquitecturas, la ejecución remota de esta función puede dar lugar a resultados imprevisibles.

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_POOL Requiere NTMS_USE_ACCESS al grupo de medios.
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 GetNtmsObjectAttribute 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

EnumerateNtmsObject

funciones de administración de objetos de

setNtmsObjectAttribute