Fonction DSCreateISecurityInfoObject (dssec.h)

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.

[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