Compartir a través de

Función SetNtmsObjectAttributeA (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 setNtmsObjectAttribute crea un atributo extendido (denominado datos privados) en el objeto RSM especificado.

Sintaxis

DWORD SetNtmsObjectAttributeA(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpObjectId,
  [in] DWORD       dwType,
  [in] LPCSTR      lpAttributeName,
  [in] LPVOID      lpAttributeData,
  [in] DWORD       dwAttributeSize
);

Parámetros

[in] hSession

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

[in] lpObjectId

GUID del objeto RSM para el que se va a crear el atributo extendido.

[in] dwType

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

[in] lpAttributeName

Nombre del atributo extendido que se va a crear.

[in] lpAttributeData

Datos definidos por el usuario.

[in] dwAttributeSize

Tamaño del búfer de lpAttributeData, en bytes.

Valor devuelto

Esta función devuelve uno de los siguientes valores.

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS se deniega al objeto o no se permite ninguna modificación para el tipo de objeto especificado (vea Comentarios). 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 actualización de la base de datos.
ERROR_INVALID_HANDLE
 El valor especificado en el parámetro hSession es NULL o no es válido.
ERROR_INVALID_NAME
 El nombre o atributo no es válido. El valor NTMS_MAXATTR_NAMELEN define la longitud máxima del nombre del atributo. La longitud incluye unNULL de .
ERROR_INVALID_PARAMETER
 El puntero es NULL o no es válido.
ERROR_NO_DATA
 El atributo especificado es mayor o igual que NTMS_MAXATTR_LENGTH.
ERROR_NOT_CONNECTED
 No se puede conectar al servicio RSM.
ERROR_OBJECT_NOT_FOUND
 El GUID no es válido.
ERROR_SUCCESS
 La función se realizó correctamente.

Observaciones

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

Para eliminar un atributo, realice un conjunto del atributo con una longitud de cero.

A continuación se muestra la lista de objetos que requieren derechos de acceso especiales.

Objeto Acceso
NTMS_CHANGER Requiere NTMS_MODIFY_ACCESS a la biblioteca.
NTMS_CHANGER_TYPE Requiere NTMS_MODIFY_ACCESS al equipo.
NTMS_COMPUTER Requiere NTMS_MODIFY_ACCESS al equipo.
NTMS_DRIVE Requiere NTMS_MODIFY_ACCESS a la biblioteca.
NTMS_DRIVE_TYPE Requiere NTMS_MODIFY_ACCESS al equipo.
NTMS_IEDOOR Requiere NTMS_MODIFY_ACCESS a la biblioteca.
NTMS_IEPORT Requiere NTMS_MODIFY_ACCESS a la biblioteca.
NTMS_LIBRARY Requiere NTMS_MODIFY_ACCESS a la biblioteca.
NTMS_LIBREQUEST Requiere NTMS_MODIFY_ACCESS a la biblioteca.
NTMS_LOGICAL_MEDIA Requiere NTMS_MODIFY_ACCESS al grupo de medios del medio lógico.
NTMS_MEDIA_POOL Requiere NTMS_MODIFY_ACCESS al grupo de medios.
NTMS_MEDIA_TYPE Requiere NTMS_MODIFY_ACCESS al equipo.
NTMS_OPREQUEST Requiere NTMS_MODIFY_ACCESS al equipo.
NTMS_PARTITION Requiere NTMS_MODIFY_ACCESS al grupo de medios del lado.
NTMS_PHYSICAL_MEDIA Requiere NTMS_MODIFY_ACCESS al grupo de medios.
NTMS_STORAGESLOT Requiere NTMS_MODIFY_ACCESS a la biblioteca.
 

Nota

El encabezado ntmsapi.h define SetNtmsObjectAttribute 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

GetNtmsObjectAttribute

funciones de administración de objetos de