Skip to content

Latest commit

 

History

History
138 lines (91 loc) · 5.96 KB

ns-winbase-actctx_section_keyed_data.md

File metadata and controls

138 lines (91 loc) · 5.96 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
NS:winbase.tagACTCTX_SECTION_KEYED_DATA
ACTCTX_SECTION_KEYED_DATA (winbase.h)
The ACTCTX_SECTION_KEYED_DATA structure is used by the FindActCtxSectionString and FindActCtxSectionGuid functions to return the activation context information along with either the GUID or 32-bit integer-tagged activation context section.
*PACTCTX_SECTION_KEYED_DATA
ACTCTX_SECTION_KEYED_DATA
ACTCTX_SECTION_KEYED_DATA structure [Side-by-side Assemblies]
PACTCTX_SECTION_KEYED_DATA
PACTCTX_SECTION_KEYED_DATA structure pointer [Side-by-side Assemblies]
_win32_actctx_section_keyed_data_str
setup.actctx_section_keyed_data_str
tagACTCTX_SECTION_KEYED_DATA
winbase/ACTCTX_SECTION_KEYED_DATA
winbase/PACTCTX_SECTION_KEYED_DATA
setup\actctx_section_keyed_data_str.htm
setup
c73160e7-fff5-4ba5-8b3a-895ac944c76d
12/05/2018
*PACTCTX_SECTION_KEYED_DATA, ACTCTX_SECTION_KEYED_DATA, ACTCTX_SECTION_KEYED_DATA structure [Side-by-side Assemblies], PACTCTX_SECTION_KEYED_DATA, PACTCTX_SECTION_KEYED_DATA structure pointer [Side-by-side Assemblies], _win32_actctx_section_keyed_data_str, setup.actctx_section_keyed_data_str, tagACTCTX_SECTION_KEYED_DATA, winbase/ACTCTX_SECTION_KEYED_DATA, winbase/PACTCTX_SECTION_KEYED_DATA
winbase.h
Windows.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Windows
ACTCTX_SECTION_KEYED_DATA, *PACTCTX_SECTION_KEYED_DATA
19H1
tagACTCTX_SECTION_KEYED_DATA
winbase/tagACTCTX_SECTION_KEYED_DATA
PACTCTX_SECTION_KEYED_DATA
winbase/PACTCTX_SECTION_KEYED_DATA
ACTCTX_SECTION_KEYED_DATA
winbase/ACTCTX_SECTION_KEYED_DATA
c++
APIRef
kbSyntax
HeaderDef
Winbase.h
ACTCTX_SECTION_KEYED_DATA

ACTCTX_SECTION_KEYED_DATA structure

-description

The ACTCTX_SECTION_KEYED_DATA structure is used by the FindActCtxSectionString and FindActCtxSectionGuid functions to return the activation context information along with either the GUID or 32-bit integer-tagged activation context section.

-struct-fields

-field cbSize

The size, in bytes, of the activation context keyed data structure.

-field ulDataFormatVersion

Number that indicates the format of the data in the section where the key was found. Clients should verify that the data format version is as expected rather than trying to interpret the values of unfamiliar data formats. This number is only changed when major non-backward-compatible changes to the section data formats need to be made. The current format version is 1.

-field lpData

Pointer to the redirection data found associated with the section identifier and key.

-field ulLength

Number of bytes in the structure referred to by lpData. Note that the data structures grow over time; do not access members in the instance data that extend beyond ulLength.

-field lpSectionGlobalData

Returned pointer to a section-specific data structure which is global to the activation context section where the key was found. Its interpretation depends on the section identifier requested.

-field ulSectionGlobalDataLength

Number of bytes in the section global data block referred to by lpSectionGlobalData.

Note that the data structures grow over time and you may receive an old format activation context data block; do not access members in the section global data that extend beyond ulSectionGlobalDataLength.

-field lpSectionBase

Pointer to the base of the section where the key was found. Some instance data contains offsets relative to the section base address, in which case this pointer value is used.

-field ulSectionTotalLength

Number of bytes for the entire section starting at lpSectionBase. May be used to verify that offset/length pairs, which are specified as relative to the section base are wholly contained in the section.

-field hActCtx

Handle to the activation context where the key was found. First, the active activation context for the thread is searched, followed by the process-default activation context and then the system-compatible-default-activation context. This member indicates which activation context contained the section and key requested. This is only returned if the FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX flag is passed.

Note that when this is returned, the caller must call ReleaseActCtx() on the activation context handle returned to release system resources when all other references to the activation context have been released.

-field ulAssemblyRosterIndex

Cardinal number of the assembly in the activation context that provided the redirection information found. This value can be presented to QueryActCtxW for more information about the contributing assembly.

-field ulFlags

-field AssemblyMetadata

-remarks

Callers should initialize the ACTCTX_SECTION_KEYED_DATA structure as such:

"ACTCTX_SECTION_KEYED_DATA askd = { sizeof(askd) };"

which initializes all members to zero/null except the size field which is set correctly.

-see-also

ACTCTX

FindActCtxSectionGuid

FindActCtxSectionString