GetNtmsObjectInformationW, 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 GetNtmsObjectInformationW(
  [in]  HANDLE                    hSession,
  [in]  LPNTMS_GUID               lpObjectId,
  [out] LPNTMS_OBJECTINFORMATIONW 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.
 

Notes

L’en-tête ntmsapi.h définit GetNtmsObjectInformation 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. La combinaison 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.

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