CoGetSystemSecurityPermissions function (objbase.h)

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