DestroyPrivateObjectSecurity function (securitybaseapi.h)

The DestroyPrivateObjectSecurity function deletes a private object's security descriptor. For background information, see the Security Descriptors for Private Objects topic.

Syntax

BOOL DestroyPrivateObjectSecurity(
  [in, out] PSECURITY_DESCRIPTOR *ObjectDescriptor
);

Parameters

[in, out] ObjectDescriptor

A pointer to a pointer to the SECURITY_DESCRIPTOR structure to be deleted. This security descriptor must have been created by a call to the CreatePrivateObjectSecurity function.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header securitybaseapi.h (include Windows.h)
Library Advapi32.lib
DLL Advapi32.dll

See also

Client/Server Access Control Functions

Client/Server Access Control Overview

CreatePrivateObjectSecurity

GetPrivateObjectSecurity

SECURITY_DESCRIPTOR

Security Descriptors for Private Objects

SetPrivateObjectSecurity