DSEditSecurity function (dssec.h)

The DSEditSecurity function displays a modal dialog box for editing security on a Directory Services (DS) object.

Syntax

HRESULT DSEditSecurity(
  [in]           HWND                   hwndOwner,
  [in]           LPCWSTR                pwszObjectPath,
  [in, optional] LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [in, optional] LPCWSTR                pwszCaption,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

Parameters

[in] hwndOwner

The dialog box owner window.

[in] pwszObjectPath

The full Active Directory Services (ADS) path of the DS object.

[in, optional] pwszObjectClass

The class of the object.

[in] dwFlags

The combination of DSSI_* flags.

[in, optional] pwszCaption

The dialog box caption.

[in, optional] pfnReadSD

The function for reading the object.

[in, optional] pfnWriteSD

The function for writing the object.

[in] lpContext

The context passed into the read or write functions in the pfnReadSD and pfnWriteSD parameters.

Return value

If the function succeeds, the function returns S_OK.

If the function fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

Requirements