Skip to content

Latest commit

 

History

History
95 lines (76 loc) · 3.25 KB

nf-winbase-createactctxa.md

File metadata and controls

95 lines (76 loc) · 3.25 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:winbase.CreateActCtxA
CreateActCtxA function (winbase.h)
The CreateActCtx function creates an activation context. (ANSI)
CreateActCtxA
winbase/CreateActCtxA
setup\createactctx.htm
setup
11508215-8d8b-4040-a725-88804103fac4
12/05/2018
CreateActCtx, CreateActCtx function [Side-by-side Assemblies], CreateActCtxA, CreateActCtxW, _win32_createactctx, setup.createactctx, winbase/CreateActCtx, winbase/CreateActCtxA, winbase/CreateActCtxW
winbase.h
Windows.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
CreateActCtxW (Unicode) and CreateActCtxA (ANSI)
Kernel32.lib
Kernel32.dll
Windows
19H1
CreateActCtxA
winbase/CreateActCtxA
c++
APIRef
kbSyntax
DllExport
Kernel32.dll
API-MS-Win-Core-sidebyside-l1-1-0.dll
KernelBase.dll
API-Ms-Win-Core-Sidebyside-Ansi-L1-1-0.dll
Kernel32Legacy.dll
CreateActCtx
CreateActCtxA
CreateActCtxW

CreateActCtxA function

-description

The CreateActCtx function creates an activation context.

-parameters

-param pActCtx [in, out]

Pointer to an ACTCTX structure that contains information about the activation context to be created.

-returns

If the function succeeds, it returns a handle to the returned activation context. Otherwise, it returns INVALID_HANDLE_VALUE.

This function sets errors that can be retrieved by calling GetLastError. For an example, see Retrieving the Last-Error Code. For a complete list of error codes, see System Error Codes.

-remarks

Set any undefined bits in dwFlags of ACTCTX to 0. If any undefined bits are not set to 0, the call to CreateActCtx that creates the activation context fails and returns an invalid parameter error code. The handle returned from CreateActCtx is passed in a call to ActivateActCtx to activate the context for the current thread.

Note

The winbase.h header defines CreateActCtx as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

-see-also

ACTCTX