Función SetNtmsObjectInformationA (ntmsapi.h)

  • Artículo

[El Administrador de almacenamiento extraíble ya no está disponible a partir de Windows 7 y Windows Server 2008 R2.]

La función SetNtmsObjectInformation cambia la estructura de información del objeto especificado.

Sintaxis

DWORD SetNtmsObjectInformationA(
  [in] HANDLE                    hSession,
  [in] LPNTMS_GUID               lpObjectId,
  [in] LPNTMS_OBJECTINFORMATIONA lpInfo
);

Parámetros

[in] hSession

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

[in] lpObjectId

Identificador único del objeto RSM.

[in] lpInfo

Puntero a una estructura de NTMS_OBJECTINFORMATION .

Valor devuelto

Esta función devuelve uno de los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS o NTMS_CONTROL_ACCESS se deniega al objeto que se está escribiendo o no se permite ninguna modificación al tipo de objeto especificado. Vea la sección Comentarios.
ERROR_SUCCESS
 La función se realizó correctamente.
ERROR_DATABASE_FAILURE
 La base de datos no es accesible o está dañada.
ERROR_DATABASE_FULL
 La base de datos está llena.
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.

Comentarios

El tamaño y el tipo de información deben establecerse para poder usar SetNtmsObjectInformation.

Todas las propiedades grabables del objeto se leen de la estructura de NTMS_OBJECTINFORMATION y se escriben en la base de datos sin tener en cuenta las operaciones de escritura que se hayan producido entre el momento en que esta aplicación llamó a la función GetNtmsObjectInformation y la función SetNtmsObjectInformation . Debido a esto, puede perder los cambios.

Para evitar resultados impredecibles, las aplicaciones deben llamar a GetNtmsObjectInformation antes de llamar a SetNtmsObjectInformation. Como se indicó anteriormente, SetNtmsObjectInformation actualiza todos los miembros grabables, 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 tienen miembros que se pueden actualizar.

Object Miembros
NTMS_CHANGER szDescription Requiere NTMS_MODIFY_ACCESS a la biblioteca.

Windows XP: No se requieren derechos de acceso.
NTMS_CHANGER_TYPE szDescription Requiere NTMS_MODIFY_ACCESS en el equipo.

Windows XP: No se requieren derechos de acceso.
NTMS_COMPUTER dwMediaPoolPolicy
 
dwLibRequestFlags
 
dwLibRequestPurgeTime
 
dwOpRequestFlags
 
dwOpRequestPurgeTime
 
szDescription Requiere NTMS_MODIFY_ACCESS en el equipo.

Windows XP: No se requieren derechos de acceso.
NTMS_DRIVE dwDeferDismountDelay
 
szDescription Requiere NTMS_MODIFY_ACCESS a la biblioteca.

Windows XP: No se requieren derechos de acceso.
NTMS_DRIVE_TYPE szDescription Requiere NTMS_MODIFY_ACCESS en el equipo.

Windows XP: No se requieren derechos de acceso.
NTMS_IEDOOR MaxOpenSecs
 
szDescription Requiere NTMS_MODIFY_ACCESS a la biblioteca.

Windows XP: No se requieren derechos de acceso.
NTMS_IEPORT MaxExtendSecs
 
szDescription Requiere NTMS_MODIFY_ACCESS a la biblioteca.

Windows XP: No se requieren derechos de acceso.
NTMS_LIBRARY Autorrecuperación
 
dwCleanerUsesRemaining
 
dwFlags
 
InventoryMethod
 
szDescription
 
szName Requiere NTMS_CONTROL_ACCESS a la biblioteca.
NTMS_LIBREQUEST szDescription Requiere NTMS_MODIFY_ACCESS a la biblioteca.

Windows XP: No se requieren derechos de acceso.
NTMS_LOGICAL_MEDIA szDescription
 
szName Requiere NTMS_MODIFY_ACCESS al grupo de medios lógicos.

Windows XP: No se requieren derechos de acceso.
NTMS_MEDIA_POOL AllocationPolicy
 
DeallocationPolicy
 
dwMaxAllocates
 
MediaType
 
szDescription
 
szName Requiere NTMS_MODIFY_ACCESS al grupo de medios.

Windows XP: Requiere NTMS_CONTROL_ACCESS al grupo de medios.
NTMS_MEDIA_TYPE szDescription Requiere NTMS_MODIFY_ACCESS en el equipo.

Windows XP: No se requieren derechos de acceso.
NTMS_OPREQUEST szDescription Requiere NTMS_MODIFY_ACCESS en el equipo.

Windows XP: No se requieren derechos de acceso.
NTMS_PARTITION szName
 
szDescription Requiere NTMS_MODIFY_ACCESS al grupo de medios del lado.

Windows XP: Requiere NTMS_CONTROL_ACCESS al grupo de medios del lado.
NTMS_PHYSICAL_MEDIA szDescription
 
szName Requiere NTMS_MODIFY_ACCESS al grupo de medios.

Windows XP: No se requieren derechos de acceso.
NTMS_STORAGESLOT szDescription Requiere NTMS_MODIFY_ACCESS a la biblioteca.

Windows XP: No se requieren derechos de acceso.
 

Nota

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

GetNtmsObjectInformation

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Funciones de administración de objetos