Edit

CoGetSystemSecurityPermissions function (objbase.h)

  • Article

Returns the default values of the Security Descriptors of the machine-wide launch and access permissions, as well as launch and access limits.

Syntax

HRESULT CoGetSystemSecurityPermissions(
  [in]  COMSD                comSDType,
  [out] PSECURITY_DESCRIPTOR *ppSD
);

Parameters

[in] comSDType

A value from the COMSD enumeration. Specifies the type of the requested system security permissions, such as launch permissions, access permissions, launch restrictions, and access restrictions.

[out] ppSD

Pointer to a caller-supplied variable that this routine sets to the address of a buffer containing the SECURITY_DESCRIPTOR for the system security permissions. Memory will be allocated by CoGetSystemSecurityPermissions and should be freed by caller with LocalFree.

Return value

This function can return one of these values.

Return code Description
S_OK
 Success.
E_INVALIDARG
 Invalid parameter comSDType or ppSD.
E_FAIL
 No connection to the resolver process.
E_OUTOFMEMORY
 Not enough memory for the security descriptor's allocation.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header objbase.h
Library Ole32.lib
DLL ComBase.dll

See also

COMSD

SECURITY_DESCRIPTOR