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