CreateBoundaryDescriptorA function (winbase.h)

Article
02/22/2024

Creates a boundary descriptor.

Syntax

HANDLE CreateBoundaryDescriptorA(
  [in] LPCSTR Name,
  [in] ULONG  Flags
);

Parameters

[in] Name

The name of the boundary descriptor.

[in] Flags

A combination of the following flags that are combined by using a bitwise OR operation.

Flag	Description
CREATE_BOUNDARY_DESCRIPTOR_ADD_APPCONTAINER_SID (0x01) Note: This value is not supported prior to Windows 8.	Required for creating a boundary descriptor in an appcontainer process, regardless of producer or consumer.

Return value

If the function succeeds, the return value is a handle to the boundary descriptor.

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

Remarks

A new boundary descriptor must have at least one security identifier (SID). To add a SID to a boundary descriptor, use the AddSIDToBoundaryDescriptor function.

To compile an application that uses this function, define _WIN32_WINNT as 0x0600 or later.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps \| UWP apps]
Target Platform	Windows
Header	winbase.h (include Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll