SetNtmsObjectInformation, fonction (ntmsapi.h)

  • Article

[Le Gestionnaire de stockage amovible n’est plus disponible depuis Windows 7 et Windows Server 2008 R2.]

La fonction SetNtmsObjectInformation modifie la structure des informations de l’objet spécifié.

Syntaxe

DWORD SetNtmsObjectInformation(
  [in] HANDLE                   hSession,
  [in] LPNTMS_GUID              lpObjectId,
  [in] LPNTMS_OBJECTINFORMATION lpInfo
);

Paramètres

[in] hSession

Handle à la session retournée par la fonction OpenNtmsSession .

[in] lpObjectId

Identificateur unique de l’objet RSM.

[in] lpInfo

Pointeur vers une structure NTMS_OBJECTINFORMATION .

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur Signification
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS ou NTMS_CONTROL_ACCESS est refusé à l’objet en cours d’écriture ou aucune modification n’est autorisée pour le type d’objet spécifié. Consultez la section Notes.
ERROR_SUCCESS
 La fonction a réussi.
ERROR_DATABASE_FAILURE
 La base de données est inaccessible ou endommagée.
ERROR_DATABASE_FULL
 La base de données est pleine.
ERROR_INVALID_HANDLE
 Le handle de session est manquant ou n’est pas valide.
ERROR_INVALID_PARAMETER
 L’ID d’objet ou la structure d’informations est manquante, ou la taille des informations d’objet ou le type d’objet n’est pas valide.
ERROR_NOT_ENOUGH_MEMORY
 Un échec d’allocation s’est produit pendant le traitement.
ERROR_OBJECT_NOT_FOUND
 L’ID d’objet n’est pas valide.

Remarques

La taille et le type des informations doivent être définis avant de pouvoir utiliser SetNtmsObjectInformation.

Toutes les propriétés accessibles en écriture pour l’objet sont lues à partir de la structure NTMS_OBJECTINFORMATION et écrites dans la base de données sans tenir compte des opérations d’écriture qui se sont produites entre le moment où cette application a appelé la fonction GetNtmsObjectInformation et la fonction SetNtmsObjectInformation . Pour cette raison, vous pouvez perdre des modifications.

Pour éviter des résultats imprévisibles, les applications doivent appeler GetNtmsObjectInformation avant d’appeler SetNtmsObjectInformation. Comme indiqué ci-dessus, SetNtmsObjectInformation met à jour tous les membres accessibles en écriture. Par conséquent, l’application est chargée de fournir une valeur pour tous les membres accessibles en écriture.

Voici la liste des objets qui ont des membres qui peuvent être mis à jour.

Object Membres
NTMS_CHANGER szDescription Nécessite NTMS_MODIFY_ACCESS à la bibliothèque.

Windows XP : Aucun droit d’accès n’est requis.
NTMS_CHANGER_TYPE szDescription Nécessite NTMS_MODIFY_ACCESS à l’ordinateur.

Windows XP : Aucun droit d’accès n’est requis.
NTMS_COMPUTER dwMediaPoolPolicy
 
dwLibRequestFlags
 
dwLibRequestPurgeTime
 
dwOpRequestFlags
 
dwOpRequestPurgeTime
 
szDescription Nécessite NTMS_MODIFY_ACCESS à l’ordinateur.

Windows XP : Aucun droit d’accès n’est requis.
NTMS_DRIVE dwDeferDismountDelay
 
szDescription Nécessite NTMS_MODIFY_ACCESS à la bibliothèque.

Windows XP : Aucun droit d’accès n’est requis.
NTMS_DRIVE_TYPE szDescription Nécessite NTMS_MODIFY_ACCESS à l’ordinateur.

Windows XP : Aucun droit d’accès n’est requis.
NTMS_IEDOOR MaxOpenSecs
 
szDescription Nécessite NTMS_MODIFY_ACCESS à la bibliothèque.

Windows XP : Aucun droit d’accès n’est requis.
NTMS_IEPORT MaxExtendSecs
 
szDescription Nécessite NTMS_MODIFY_ACCESS à la bibliothèque.

Windows XP : Aucun droit d’accès n’est requis.
NTMS_LIBRARY Récupération automatique
 
dwCleanerUsesRemaining
 
dwFlags
 
InventoryMethod
 
szDescription
 
szName Nécessite NTMS_CONTROL_ACCESS à la bibliothèque.
NTMS_LIBREQUEST szDescription Nécessite NTMS_MODIFY_ACCESS à la bibliothèque.

Windows XP : Aucun droit d’accès n’est requis.
NTMS_LOGICAL_MEDIA szDescription
 
szName Nécessite NTMS_MODIFY_ACCESS au pool de médias du média logique.

Windows XP : Aucun droit d’accès n’est requis.
NTMS_MEDIA_POOL AllocationPolicy
 
DeallocationPolicy
 
dwMaxAllocates
 
MediaType
 
szDescription
 
szName Nécessite NTMS_MODIFY_ACCESS au pool de médias.

Windows XP : Nécessite NTMS_CONTROL_ACCESS au pool de médias.
NTMS_MEDIA_TYPE szDescription Nécessite NTMS_MODIFY_ACCESS à l’ordinateur.

Windows XP : Aucun droit d’accès n’est requis.
NTMS_OPREQUEST szDescription Nécessite NTMS_MODIFY_ACCESS à l’ordinateur.

Windows XP : Aucun droit d’accès n’est requis.
NTMS_PARTITION szName
 
szDescription Nécessite NTMS_MODIFY_ACCESS au pool multimédia du côté.

Windows XP : Nécessite NTMS_CONTROL_ACCESS au pool multimédia du côté.
NTMS_PHYSICAL_MEDIA szDescription
 
szName Nécessite NTMS_MODIFY_ACCESS au pool de médias.

Windows XP : Aucun droit d’accès n’est requis.
NTMS_STORAGESLOT szDescription Nécessite NTMS_MODIFY_ACCESS à la bibliothèque.

Windows XP : Aucun droit d’accès n’est requis.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête ntmsapi.h
Bibliothèque Ntmsapi.lib
DLL Ntmsapi.dll

Voir aussi

GetNtmsObjectInformation

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Fonctions de gestion des objets