GetNtmsObjectSecurity, fonction (ntmsapi.h)

  • Article

[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