DSCreateSecurityPage, fonction (dssec.h)

Article
08/23/2023

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

Partager via