GetNtmsObjectInformationW, fonction (ntmsapi.h)

Article
11/20/2024

[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

Gérez 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 de l’objet.

Valeur de retour

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 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 d’informations de la structure d’informations doivent être définis correctement dans le paramètre lpInfo avant d’utiliser la fonction GetNtmsObjectInformation.

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

Objet	Accès
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 supports 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 multimédia du côté.
NTMS_PHYSICAL_MEDIA	Nécessite NTMS_USE_ACCESS au pool de supports.
NTMS_STORAGESLOT	Nécessite NTMS_USE_ACCESS à la bibliothèque.

Note

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

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

fonctions de gestion des objets

SetNtmsObjectInformation

Partager via