SetNtmsObjectInformation, fonction (ntmsapi.h)

Article
02/29/2024

[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

Partager via