Fonction DSCreateISecurityInfoObject (dssec.h)

  • Article

La fonction DSCreateISecurityInfoObject crée un instance de l’interface ISecurityInformation associée à l’objet de service d’annuaire (DS) spécifié.

Syntaxe

HRESULT DSCreateISecurityInfoObject(
  [in]           LPCWSTR                pwszObjectPath,
  [in]           LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          LPSECURITYINFO         *ppSI,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

Paramètres

[in] pwszObjectPath

Chemin d’accès complet de l’objet DS pour lequel créer un instance de l’interface ISecurityInformation.

[in] pwszObjectClass

Classe de l’objet spécifié par le paramètre pwszObjectPath .

[in] dwFlags

Indicateurs utilisés pour la page de propriétés de sécurité associée à la nouvelle instance de l’interface ISecurityInformation. Ce paramètre peut être 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 ( System Access Control List ) 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
 Supprimez les messages contextuels en lecture seule.

[out] ppSI

Pointeur vers le instance de l’interface ISecurityInformation créée par cette fonction.

[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, DSCreateISecurityInfoObject 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, DSCreateISecurityInfoObject 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 les paramètres pfnReadSD et 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.

Spécifications

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