CoGetSystemSecurityPermissions function

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 WINAPI CoGetSystemSecurityPermissions(
  _In_  COMSD                comSDType,
  _Out_ PSECURITY_DESCRIPTOR *ppSD
);

Parameters

comSDType [in]

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.

ppSD [out]

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 codeDescription
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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Objbase.h

Library

Ole32.lib

DLL

ComBase.dll

See also

COMSD
SECURITY_DESCRIPTOR

 

 

Show: