Función GetNtmsObjectAttributeW (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 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 del 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 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_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.

Comentarios

La función GetNtmsObjectAttribute debe ejecutarse en el servidor RSM. Dado que el búfer de bytes no está registrado entre sistemas de arquitecturas diferentes, 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.

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

 

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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

EnumerateNtmsObject

Funciones de administración de objetos

SetNtmsObjectAttribute