IX509PrivateKey::put_SecurityDescriptor method (certenroll.h)

The SecurityDescriptor property specifies or retrieves the security descriptor for the private key.

This property is read/write.

Syntax

HRESULT put_SecurityDescriptor(
  BSTR Value
);

Parameters

Value

Return value

None

Remarks

To use the security descriptor, you must call the ConvertStringSecurityDescriptorToSecurityDescriptor function included with the Microsoft Authorization API and specify the string returned by the GetDefaultSecurityDescriptor method.

The security descriptor is used to define access to private keys for the computer and user in the following manner:

  • By default, only local administrators and services running under the LocalSystem account can access private keys associated with the computer account.
  • When a CSP stores the private key of a user in an encrypted file in the user profile, it uses a security descriptor to set access permissions to the file.

If the key is not open when you specify a descriptor, the property value will be set when the key is opened.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header certenroll.h
DLL CertEnroll.dll

See also

IX509PrivateKey