Location: Symbol Reference > Classes > TJwSecureRegistryKey Class > TJwSecureRegistryKey Methods > TJwSecureRegistryKey.GetSecurityDescriptorEx Method
JWSCL Documentation
ContentsIndexHome
PreviousUpNext
TJwSecureRegistryKey.GetSecurityDescriptorEx Method
Pascal
class function GetSecurityDescriptorEx(const KeyName: TJwString; const aSecurityInfo: TJwSecurityInformationFlagSet; bUseWOW64: boolean): TJwSecurityDescriptor; virtual;
Parameters 
Description 
const KeyName: TJwString 
receives the key path which security descriptor is to be retrieved. It can be a UNC path that allows to retrieve a security descriptor of a key on a remote machine. For more information see ParseUNC  
const aSecurityInfo: TJwSecurityInformationFlagSet 
defines which security information in the security descriptor is to be retrieved.  
bUseWOW64: boolean 
is only used on the local machine (if KeyName is not a remote UNC path) and defines the constant SE_REGISTRY_WOW64_32KEY that indicates an object for a registry entry under WOW64. Set it to true to use it; otherwise false.  

Returns a new instance of the security descriptor. The caller is responsible for freeing it.

GetSecurityDescriptorEx tries to get the security descriptor of a local or remote registry key. To connect to a remote registry use a UNC path (\serverrootsubkey) in parameter KeyName. 

 

Exceptions 
Description 
will be raised if parameter KeyName is invalid. Validity is only checked for a correct root item. 
will be raised if a call to a winapi function failed. To get the name of the function that failed, use the property WinCallName of the exception. It contains the name of the function that failed. 
Copyright (c) 2010. All rights reserved.
This help was created by Doc-O-Matic sponsored by toolsfactory software inc.
What do you think about this topic? Send feedback!