Función SetNtmsObjectInformation (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 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