GetNtmsObjectInformation, fonction (ntmsapi.h)

  • Article

[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