GetNtmsObjectSecurity, fonction (ntmsapi.h)

Article
02/29/2024

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

La fonction GetNtmsObjectSecurity lit le descripteur de sécurité de l’objet RSM spécifié.

Syntaxe

DWORD GetNtmsObjectSecurity(
  [in]  HANDLE               hSession,
  [in]  LPNTMS_GUID          lpObjectId,
  [in]  DWORD                dwType,
  [in]  SECURITY_INFORMATION RequestedInformation,
  [out] PSECURITY_DESCRIPTOR lpSecurityDescriptor,
  [in]  DWORD                nLength,
  [out] LPDWORD              lpnLengthNeeded
);

Paramètres

[in] hSession

Gérez la session retournée par la fonction OpenNtmsSession .

[in] lpObjectId

Identificateur unique de l’objet RSM.

[in] dwType

Type d'objet. Pour obtenir la liste des types d’objets, consultez NtmsObjectsTypes.

[in] RequestedInformation

Valeur SECURITY_INFORMATION qui spécifie les données de sécurité demandées.

[out] lpSecurityDescriptor

Pointeur vers une structure SECURITY_DESCRIPTOR qui reçoit le descripteur de sécurité.

[in] nLength

Longueur du descripteur.

[out] lpnLengthNeeded

Longueur requise de la mémoire tampon si elle n’est pas assez grande pour le descripteur de sécurité, en octets.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	READ_CONTROL l’accès à l’objet est refusé. Windows XP : Aucun droit d’accès n’est requis.
ERROR_DATABASE_FAILURE	La base de données est inaccessible ou endommagée.
ERROR_INVALID_HANDLE	Le handle de session est manquant ou n’est pas valide.
ERROR_INVALID_PARAMETER	L’ID d’objet est manquant.
ERROR_NO_SECURITY_ON_OBJECT	Il n’existe aucune information de sécurité pour cet objet.
ERROR_OBJECT_NOT_FOUND	L’ID d’objet n’est pas valide.
ERROR_SUCCESS	La fonction a réussi.

Remarques

La sécurité RSM utilise les descripteurs de sécurité et les membres d’informations standard. Cela permet d’utiliser les boîtes de dialogue de sécurité standard pour sélectionner sécurité RSM. Pour plus d’informations, consultez la fonction SetPrivateObjectSecurity . Pour plus d’informations sur la sécurité RSM, consultez Sécurité RSM.

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

EnumerateNtmsObject

Fonctions de gestion des objets

SetNtmsObjectSecurity

Partager via