Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

DSCreateISecurityInfoObject function

The DSCreateISecurityInfoObject function creates an instance of the ISecurityInformation interface associated with the specified directory service (DS) object.

Syntax


HRESULT WINAPI DSCreateISecurityInfoObject(
  _In_      LPCWSTR pwszObjectPath,
  _In_      LPCWSTR pwszObjectClass,
  _In_      DWORD dwFlags,
  _Out_     LPSECURITYINFO *ppSI,
  _In_opt_  PFNREADOBJECTSECURITY pfnReadSD,
  _In_opt_  PFNWRITEOBJECTSECURITY pfnWriteSD,
  _In_      LPARAM lpContext
);

Parameters

pwszObjectPath [in]

The full path of the DS object for which to create an instance of the ISecurityInformation interface.

pwszObjectClass [in]

The class of the object specified by the pwszObjectPath parameter.

dwFlags [in]

Flags used for the security property page associated with the new instance of the ISecurityInformation interface. This parameter can be any combination of the following flags.

ValueMeaning
DSSI_READ_ONLY
0x00000001

The security properties are read-only.

DSSI_NO_ACCESS_CHECK
0x00000002

No access check is performed.

DSSI_NO_EDIT_SACL
0x00000004

The system access control list (SACL) property is read-only.

DSSI_NO_EDIT_OWNER
0x00000008

The object owner property is read-only.

DSSI_IS_ROOT
0x00000010

The object is a root object.

DSSI_NO_FILTER
0x00000020

Do not apply any filters.

DSSI_NO_READONLY_MESSAGE
0x00000040

Suppress read-only popup messages.

 

ppSI [out]

A pointer to the instance of the ISecurityInformation interface this function creates.

pfnReadSD [in, optional]

A pointer to a function used to read the security descriptor of the object. This value can be NULL. If pfnReadSD is not NULL, DSCreateISecurityInfoObject calls the function referenced by pfnReadSD to retrieve the security descriptor of the object.

pfnWriteSD [in, optional]

A pointer to a function used to write the security descriptor of the object. This value can be NULL. If pfnWriteSD is not NULL, DSCreateISecurityInfoObject calls the function referenced by pfnWriteSD to write the security descriptor of the object.

lpContext [in]

Context to pass to the functions identified by 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

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

DSSec.h

Library

DSSec.lib

DLL

DSSec.dll

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.