Partager via


DSCreateSecurityPage, fonction (dssec.h)

La fonction DSCreateSecurityPage crée une page de propriétés de sécurité pour un objet Active Directory. La page de propriétés résultante peut être ajoutée à une feuille de propriétés.

Syntaxe

HRESULT DSCreateSecurityPage(
  [in]           LPCWSTR                pwszObjectPath,
  [in, optional] LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          HPROPSHEETPAGE         *phPage,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

Paramètres

[in] pwszObjectPath

Pointeur vers une chaîne de caractères larges terminée par null qui représente le chemin d’accès Active Directory complet de l’objet.

[in, optional] pwszObjectClass

Pointeur vers une chaîne de caractères larges terminée par null qui représente la classe d’objet. Cette valeur peut être NULL.

[in] dwFlags

Indicateurs utilisés pour la page de propriétés de sécurité. Ce paramètre peut être aucun ou n’importe quelle combinaison des indicateurs suivants.

Valeur Signification
DSSI_READ_ONLY
0x00000001
Les propriétés de sécurité sont en lecture seule.
DSSI_NO_ACCESS_CHECK
0x00000002
Aucun case activée d’accès n’est effectué.
DSSI_NO_EDIT_SACL
0x00000004
La propriété SACL ( liste de contrôle d’accès système ) est en lecture seule.
DSSI_NO_EDIT_OWNER
0x00000008
La propriété propriétaire de l’objet est en lecture seule.
DSSI_IS_ROOT
0x00000010
L’objet est un objet racine.
DSSI_NO_FILTER
0x00000020
N’appliquez aucun filtre.
DSSI_NO_READONLY_MESSAGE
0x00000040
Supprimer les messages contextuels en lecture seule.

[out] phPage

Pointeur vers une page HPROPSHEETPAGE qui retourne la page de propriétés de sécurité créée.

[in, optional] pfnReadSD

Pointeur vers une fonction utilisée pour lire le descripteur de sécurité de l’objet . Cette valeur peut être NULL. Si pfnReadSD n’a pas la valeur NULL, DSCreateSecurityPage appelle la fonction référencée par pfnReadSD pour récupérer le descripteur de sécurité de l’objet.

[in, optional] pfnWriteSD

Pointeur vers une fonction utilisée pour écrire le descripteur de sécurité de l’objet . Cette valeur peut être NULL. Si pfnWriteSD n’a pas la valeur NULL, DSCreateSecurityPage appelle la fonction référencée par pfnWriteSD pour écrire le descripteur de sécurité de l’objet.

[in] lpContext

Contexte à passer aux fonctions identifiées par pfnReadSD ou pfnWriteSD.

Valeur retournée

Si la fonction réussit, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Notes

La fonction pointée par pfnReadSD est définie comme suit.

#include <windows.h>

typedef HRESULT (WINAPI *PFNREADOBJECTSECURITY)(
    LPCWSTR,               // Active Directory path of object
    SECURITY_INFORMATION,  // the security information to read
    PSECURITY_DESCRIPTOR*, // the returned security descriptor 
    LPARAM                 // context parameter
);

La fonction DSCreateSecurityPage libère le descripteur de sécurité retourné dans le troisième paramètre ci-dessus par un appel à la fonction LocalFree .

La fonction pointée par pfnWriteSD est définie comme suit.

#include <windows.h>

typedef HRESULT (WINAPI *PFNWRITEOBJECTSECURITY)(
    LPCWSTR,              // Active Directory path of object
    SECURITY_INFORMATION, // the security information to write
    PSECURITY_DESCRIPTOR, // the security descriptor to write
    LPARAM                // context parameter
);

Spécifications

   
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête dssec.h
Bibliothèque DSSec.lib
DLL DSSec.dll

Voir aussi

Page des propriétés de sécurité de base

ISecurityInformation