Skip to content

Latest commit

 

History

History
135 lines (79 loc) · 4.86 KB

nf-iads-iadssecurityutility-getsecuritydescriptor.md

File metadata and controls

135 lines (79 loc) · 4.86 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:iads.IADsSecurityUtility.GetSecurityDescriptor
IADsSecurityUtility::GetSecurityDescriptor (iads.h)
Retrieves a security descriptor for the specified file, fileshare, or registry key.
ADS_SD_FORMAT_HEXSTRING
ADS_SD_FORMAT_IID
ADS_SD_FORMAT_RAW
File
File share
GetSecurityDescriptor
GetSecurityDescriptor method [ADSI]
GetSecurityDescriptor method [ADSI]
IADsSecurityUtility interface
IADsSecurityUtility interface [ADSI]
GetSecurityDescriptor method
IADsSecurityUtility.GetSecurityDescriptor
IADsSecurityUtility::GetSecurityDescriptor
Registry key
_ds_iadssecurityutility_getsecuritydescriptor
adsi.iadssecurityutility__getsecuritydescriptor
adsi.iadssecurityutility_getsecuritydescriptor
iads/IADsSecurityUtility::GetSecurityDescriptor
adsi\iadssecurityutility_getsecuritydescriptor.htm
adsi
95f4fbd9-03f8-4f2f-9314-e628186e51a4
12/05/2018
ADS_SD_FORMAT_HEXSTRING, ADS_SD_FORMAT_IID, ADS_SD_FORMAT_RAW, File, File share, GetSecurityDescriptor, GetSecurityDescriptor method [ADSI], GetSecurityDescriptor method [ADSI],IADsSecurityUtility interface, IADsSecurityUtility interface [ADSI],GetSecurityDescriptor method, IADsSecurityUtility.GetSecurityDescriptor, IADsSecurityUtility::GetSecurityDescriptor, Registry key, _ds_iadssecurityutility_getsecuritydescriptor, adsi.iadssecurityutility__getsecuritydescriptor, adsi.iadssecurityutility_getsecuritydescriptor, iads/IADsSecurityUtility::GetSecurityDescriptor
iads.h
Windows
Windows Vista
Windows Server 2008
Activeds.dll
Windows
19H1
IADsSecurityUtility::GetSecurityDescriptor
iads/IADsSecurityUtility::GetSecurityDescriptor
c++
APIRef
kbSyntax
COM
Activeds.dll
IADsSecurityUtility.GetSecurityDescriptor

IADsSecurityUtility::GetSecurityDescriptor

-description

The GetSecurityDescriptor method retrieves a security descriptor for the specified file, fileshare, or registry key.

-parameters

-param varPath [in]

A VARIANT string that contains the path of the object to retrieve the security descriptor for.

File

A valid file path syntax. For example: "c:\specs\public\adxml.doc" or "\adsi\public\dsclient.exe".

File share

A valid file path syntax for a file share. For example: "\adsi\public".

Registry key

A valid registry syntax. For example, "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ADs".

-param lPathFormat [in]

Contains one of the ADS_PATHTYPE_ENUM values which specifies the format of the varPath parameter.

-param lFormat [in]

Contains one of the ADS_SD_FORMAT_ENUM values which specifies the format of the security descriptor returned in the pVariant parameter. The following list identifies the possible values for this parameter and the format that is supplied in the pVariant parameter.

ADS_SD_FORMAT_IID

pVariant receives a VT_DISPATCH that can be queried for the IADsSecurityDescriptor interface.

ADS_SD_FORMAT_RAW

pVariant receives a VT_I1 | VT_ARRAY that contains the security descriptor in raw data format. This is in the format of a SECURITY_DESCRIPTOR structure.

ADS_SD_FORMAT_HEXSTRING

pVariant receives a VT_BSTR that contains the raw security descriptor in hex encode string format.

-param pVariant [out]

Pointer to a VARIANT that receives the returned security descriptor. The format of the retrieved security descriptor is specified by the lFormat parameter.

-returns

Returns S_OK if successful or a COM or Win32 error code otherwise. Possible error codes include the following.

-see-also

ADS_PATHTYPE_ENUM

ADS_SD_FORMAT_ENUM

IADsSecurityDescriptor

IADsSecurityUtility

SECURITY_DESCRIPTOR

SetSecurityDescriptor