ObReleaseObjectSecurity function (wdm.h)

Article
02/22/2024

The ObReleaseObjectSecurity routine is the reciprocal to ObGetObjectSecurity.

Syntax

void ObReleaseObjectSecurity(
  [in] PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in] BOOLEAN              MemoryAllocated
);

Parameters

[in] SecurityDescriptor

Pointer to the buffered SECURITY_DESCRIPTOR to be released. The caller obtained this parameter from ObGetObjectSecurity

[in] MemoryAllocated

Specifies the value also obtained from ObGetObjectSecurity.

Return value

None

Remarks

After a successful call to ObGetObjectSecurity, a driver must call ObReleaseObjectSecurity eventually.

ObReleaseObjectSecurity releases any resources that were allocated by ObGetObjectSecurity. It also decrements the reference count on the given security descriptor.

Requirements

Requirement	Value
Minimum supported client	Available starting with Windows 2000.
Target Platform	Universal
Header	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<=APC_LEVEL
DDI compliance rules	HwStorPortProhibitedDDIs(storport), IrqlApcLte(wdm)