RtUpdateProcThreadAttribute

RtUpdateProcThreadAttribute updates the specified attribute in a list of attributes for process and thread creation.

Syntax

BOOL RtUpdateProcThreadAttribute(
    LPPROC_THREAD_ATTRIBUTE_LIST lpAttributeList,  
    DWORD dwFlags,
    DWORD_PTR Attribute,
    PVOID lpValue,  
    SIZE_T cbSize,
    PVOID lpPreviousValue,
    PSIZE_T lpReturnSize
);

Parameters

lpAttributeList

A pointer to an attribute list created by the RtInitializeProcThreadAttributeList function.

dwFlags

This parameter is reserved and must be zero.

Attribute

The attribute key to update in the attribute list. This parameter can be one of the following values:

Value	Meaning
RT_PROC_THREAD_ATTRIBUTE_USE_LOCAL_MEMORY	The lpValue parameter is a pointer to a BOOLEAN which specifies whether or not to use local memory.
RT_PROC_THREAD_ATTRIBUTE_IDEAL_PROCESSOR	The lpValue parameter is a pointer to a ULONG that specifies the ideal processor for the new thread.
RT_PROC_THREAD_ATTRIBUTE_PROCESS_AFFINITY	The lpValue parameter is a pointer to a KAFFINITY structure which specifies the processors to affine the process to.

lpValue

A pointer to the attribute value. This value should persist until the attribute is destroyed using the RtDeleteProcThreadAttributeList function.

cbSize

The size of the attribute value specified by the lpValue parameter.

lpPreviousValue

This parameter is reserved and must be NULL.

lpReturnSize

This parameter is reserved and must be NULL.

Return Value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is 0 (zero). For extended error information, call GetLastError.

Remarks

An attribute list is an opaque structure that consists of a series of key/value pairs, one for each attribute. A process can update only the attribute keys described in this topic.

See Also

RtInitializeProcThreadAttributeList

RtDeleteProcThreadAttributeList