Función SetNtmsObjectInformation (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 SetNtmsObjectInformation(
  [in] HANDLE                   hSession,
  [in] LPNTMS_GUID              lpObjectId,
  [in] LPNTMS_OBJECTINFORMATION 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.

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