DSCreateISecurityInfoObjectEx function (dssec.h)
The DSCreateISecurityInfoObjectEx function creates an instance of the ISecurityInformation interface associated with the specified directory service (DS) object on the specified server.
Syntax
HRESULT DSCreateISecurityInfoObjectEx(
[in] LPCWSTR pwszObjectPath,
[in] LPCWSTR pwszObjectClass,
[in] LPCWSTR pwszServer,
[in] LPCWSTR pwszUserName,
[in] LPCWSTR pwszPassword,
[in] DWORD dwFlags,
[out] LPSECURITYINFO *ppSI,
[in, optional] PFNREADOBJECTSECURITY pfnReadSD,
[in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
[in] LPARAM lpContext
);
Parameters
[in] pwszObjectPath
The full path of the DS object for which to create an instance of the ISecurityInformation interface.
[in] pwszObjectClass
The class of the object specified by the pwszObjectPath parameter.
[in] pwszServer
The server of the object specified by the pwszObjectPath parameter. If the value of this parameter is NULL, the server is obtained from the path specified by the pwszObjectPath parameter.
[in] pwszUserName
A user name to be associated with the new ISecurityInformation object. If the value of this parameter is NULL, the Active Directory Services Interfaces (ADSI) default is used.
[in] pwszPassword
A password to be associated with the new ISecurityInformation object. If the value of this parameter is NULL, the Active Directory Services Interfaces (ADSI) default is used.
[in] dwFlags
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.
Value | Meaning |
---|---|
|
The security properties are read-only. |
|
No access check is performed. |
|
The system access control list (SACL) property is read-only. |
|
The object owner property is read-only. |
|
The object is a root object. |
|
Do not apply any filters. |
|
Suppress read-only popup messages. |
[out] ppSI
A pointer to the instance of the ISecurityInformation interface this function creates.
[in, optional] pfnReadSD
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.
[in, optional] pfnWriteSD
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.
[in] lpContext
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
Requirement | Value |
---|---|
Minimum supported client | None supported |
Minimum supported server | Windows Server 2008 [desktop apps only] |
Target Platform | Windows |
Header | dssec.h |
Library | DSSec.lib |
DLL | DSSec.dll |