GetNtmsObjectInformationW, fonction (ntmsapi.h)
[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 |
---|---|
|
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. |
|
Le handle de session est manquant ou n’est pas valide. |
|
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. |
|
Un échec d’allocation s’est produit pendant le traitement. |
|
L’ID d’objet n’est pas valide. |
|
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 |