SetNtmsObjectSecurity, fonction (ntmsapi.h)

  • Article

[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