SetNtmsObjectSecurity, fonction (ntmsapi.h)

Article
08/25/2023

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

La fonction SetNtmsObjectSecurity écrit le descripteur de sécurité pour l’objet RSM spécifié.

Syntaxe

DWORD SetNtmsObjectSecurity(
  [in] HANDLE               hSession,
  [in] LPNTMS_GUID          lpObjectId,
  [in] DWORD                dwType,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR lpSecurityDescriptor
);

Paramètres

[in] hSession

Handle à la session retournée par la fonction OpenNtmsSession .

[in] lpObjectId

Identificateur unique de l’objet RSM.

[in] dwType

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

[in] SecurityInformation

Valeur SECURITY_INFORMATION qui spécifie les informations de sécurité à écrire dans l’objet RSM.

[in] lpSecurityDescriptor

Pointeur vers une structure de SECURITY_DESCRIPTOR qui spécifie le descripteur de sécurité à écrire dans l’objet RSM : NTMS_USE_ACCESS, NTMS_CONTROL_ACCESS ou NTMS_MODIFY_ACCESS.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur	Signification
ERROR_ACCESS_DENIED	Les privilèges requis pour modifier le descripteur de sécurité sont refusés.
ERROR_DATABASE_FAILURE	La base de données est inaccessible ou endommagée.
ERROR_DATABASE_FULL	La base de données est pleine.
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.

Notes

Si une application utilise SetNtmsObjectSecurity pour définir la liste de contrôle d’accès discrétionnaire (ACL) d’un objet, l’application doit avoir WRITE_DAC autorisation ou être propriétaire de l’objet.

Si une application utilise SetNtmsObjectSecurity pour définir la liste de contrôle d’accès système d’un objet, le privilège SE_SECURITY_NAME doit être activé pour l’application. Pour plus d’informations, consultez la fonction SetPrivateObjectSecurity . Pour plus d’informations sur la sécurité RSM, consultez Sécurité RSM.

Spécifications


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

GetNtmsObjectSecurity

Fonctions de gestion des objets

Partager via