InitializeProcThreadAttributeList (kernel32)
Last changed: -186.136.223.176

.
Summary

C# Signature:

[DllImport("kernel32.dll", SetLastError=true)]
[return: MarshalAs(UnmanagedType.Bool)]
public static extern bool InitializeProcThreadAttributeList(
     IntPtr lpAttributeList,
     int dwAttributeCount,
     int dwFlags,
     ref IntPtr lpSize);

VB Signature:

Declare Function InitializeProcThreadAttributeList Lib "kernel32.dll" (TODO) As TODO

User-Defined Types:

None.

Alternative Managed API:

Do you know one? Please contribute it!

Notes:

Call it once to get the required size, allocate that memory, call it again to initialize.

Save the attribute list to the STARTUPINFOEX struct, use UpdateProcThreadAddtributeList to fill in the now-reserved attribute entries.

Tips & Tricks:

None.

Sample Code:

    ...
    if (attributeCount > 0)
    {
        flags = flags | EXTENDED_STARTUPINFO_PRESENT;
        startupInfoEx.lpAttributeList = InitializeProcThreadAttributeList(attributeCount);
    }
    ...

    private static IntPtr InitializeProcThreadAttributeList(int attributeCount)
    {
        const int reserved = 0;
        var size = IntPtr.Zero;
        bool wasInitialized = InitializeProcThreadAttributeList(IntPtr.Zero, attributeCount, reserved, ref size);
        if (wasInitialized || size == IntPtr.Zero)
        {
        throw new Exception(string.Format("Couldn't get the size of the attribute list for {0} attributes", attributeCount));
        }

        IntPtr lpAttributeList = Marshal.AllocHGlobal(size);
        if (lpAttributeList == IntPtr.Zero)
        {
        throw new Exception("Couldn't reserve space for a new attribute list");
        }

        wasInitialized = InitializeProcThreadAttributeList(lpAttributeList, attributeCount, reserved, ref size);
        if (!wasInitialized)
        {
        throw new Exception("Couldn't create new attribute list");
        }

        return lpAttributeList;
    }

Documentation