Partager via

SetNtmsObjectInformationW, fonction (ntmsapi.h)

  • Article

[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 SetNtmsObjectInformationW(
  [in] HANDLE                    hSession,
  [in] LPNTMS_GUID               lpObjectId,
  [in] LPNTMS_OBJECTINFORMATIONW lpInfo
);

Paramètres

[in] hSession

Gérez 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 de retour

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 au type d’objet spécifié. Voir les remarques.
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 complète.
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 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. En raison de cela, vous pouvez perdre des modifications.

Pour éviter les 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.

Objet 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 de 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 supports 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 multimédia.

Windows XP : nécessite NTMS_CONTROL_ACCESS au pool multimédia.
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 multimédia.

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.
 

Note

L’en-tête ntmsapi.h définit SetNtmsObjectInformation en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence Valeur
client minimum pris en charge Windows XP [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2003 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête ntmsapi.h
bibliothèque Ntmsapi.lib
DLL Ntmsapi.dll

Voir aussi

GetNtmsObjectInformation

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

fonctions de gestion des objets