Función GetNtmsObjectAttributeA (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 GetNtmsObjectAttributeA(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpObjectId,
[in] DWORD dwType,
[in] LPCSTR 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 |
|---|---|
|
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 en la consulta o actualización de la base de datos. |
|
El tamaño del búfer no se especifica correctamente. El tamaño correcto se devuelve en el parámetro lpAttributeSize . |
|
El valor especificado en el parámetro hSession es NULL o no es válido. |
|
El puntero es NULL o no es válido. |
|
No se puede conectar al servicio RSM. |
|
No se encontró el atributo especificado. |
|
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 |