ORSetKeySecurity function

Sets the security of an open registry key in an offline registry hive.

Syntax

DWORD ORSetKeySecurity(
  _In_ ORHKEY               Handle,
  _In_ SECURITY_INFORMATION SecurityInformation,
  _In_ PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parameters

Handle [in]

A handle to an open registry key in an offline registry hive.

SecurityInformation [in]

Bit flags that indicate the type of security information to set. This parameter can be a combination of the SECURITY_INFORMATION bit flags.

pSecurityDescriptor [in]

A pointer to a SECURITY_DESCRIPTOR structure that specifies the security attributes to set for the specified key.

Return value

If the function succeeds, the function returns ERROR_SUCCESS.

If the function fails, it returns a nonzero error code defined in Winerror.h. You can use the FormatMessage function with the FORMAT_MESSAGE_FROM_SYSTEM flag to get a generic description of the error.

Requirements

Requirement	Value
Redistributable	Windows Offline Registry library version 1.0 or later
Header	Offreg.h
DLL	Offreg.dll

See also

ORCloseKey

ORDeleteKey

OROpenKey

ORGetKeySecurity

SECURITY_DESCRIPTOR

SECURITY_INFORMATION