GetNtmsObjectInformation, fonction (ntmsapi.h)

Article
08/25/2023

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

La fonction GetNtmsObjectInformation retourne la structure d’informations d’un objet pour l’objet spécifié.

Syntaxe

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

Paramètres

[in] hSession

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

[in] lpObjectId

Identificateur unique de l’objet RSM.

[out] lpInfo

Pointeur vers une structure NTMS_OBJECTINFORMATION qui reçoit les informations sur l’objet.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	NTMS_USE_ACCESS à l’objet ou à son conteneur est refusé. D’autres erreurs de sécurité sont également possibles, mais elles indiquent une erreur de sous-système de sécurité. Windows XP : Aucun droit d’accès n’est requis.
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.
ERROR_SUCCESS	La fonction a réussi.

Remarques

La taille et le type des informations de la structure d’informations doivent être définis correctement dans le paramètre lpInfo avant d’utiliser la fonction GetNtmsObjectInformation .

Pour éviter des résultats imprévisibles, les applications doivent appeler la fonction GetNtmsObjectInformation avant d’appeler la fonction SetNtmsObjectInformation . La fonction SetNtmsObjectInformation met à jour tous les membres accessibles en écriture de la structure NTMS_OBJECTINFORMATION . 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 nécessitent des droits d’accès spéciaux.

Object	Access
NTMS_CHANGER	Nécessite NTMS_USE_ACCESS à la bibliothèque.
NTMS_CHANGER_TYPE	Nécessite NTMS_USE_ACCESS à l’ordinateur.
NTMS_COMPUTER	Nécessite NTMS_USE_ACCESS à l’ordinateur.
NTMS_DRIVE	Nécessite NTMS_USE_ACCESS à la bibliothèque.
NTMS_DRIVE_TYPE	Nécessite NTMS_USE_ACCESS à l’ordinateur.
NTMS_IEDOOR	Nécessite NTMS_USE_ACCESS à la bibliothèque.
NTMS_IEPORT	Nécessite NTMS_USE_ACCESS à la bibliothèque.
NTMS_LIBRARY	Nécessite NTMS_USE_ACCESS à la bibliothèque.
NTMS_LIBREQUEST	Nécessite NTMS_USE_ACCESS à la bibliothèque.
NTMS_LOGICAL_MEDIA	Nécessite NTMS_USE_ACCESS au pool de médias du média logique.
NTMS_MEDIA_TYPE	Nécessite NTMS_USE_ACCESS à l’ordinateur.
NTMS_OPREQUEST	Nécessite NTMS_USE_ACCESS à l’ordinateur.
NTMS_PARTITION	Nécessite NTMS_USE_ACCESS au pool de médias du côté.
NTMS_PHYSICAL_MEDIA	Nécessite NTMS_USE_ACCESS au pool de médias.
NTMS_STORAGESLOT	Nécessite NTMS_USE_ACCESS à la bibliothèque.

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

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

Fonctions de gestion des objets

SetNtmsObjectInformation

Partager via