FindActCtxSectionString function

The FindActCtxSectionString function retrieves information on a specific string in the current activation context and returns a ACTCTX_SECTION_KEYED_DATA structure.

Syntax


BOOL FindActCtxSectionString(
  _In_   DWORD dwFlags,
  _In_   const GUID *lpExtensionGuid,
  _In_   ULONG ulSectionId,
  _In_   LPCTSTR lpStringToFind,
  _Out_  PACTCTX_SECTION_KEYED_DATA ReturnedData
);

Parameters

dwFlags [in]

Flags that determine how this function is to operate. Only the following flag is currently defined.

ValueMeaning
FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX

This function returns the activation context handle where the redirection data was found in the hActCtx member of the ACTCTX_SECTION_KEYED_DATA structure. The caller must use ReleaseActCtx to release this activation context.

 

lpExtensionGuid [in]

Reserved; must be null.

ulSectionId [in]

Identifier of the string section of the activation context in which to search for the specific string.

The following are valid string section identifiers:

  • ACTIVATION_CONTEXT_SECTION_ASSEMBLY_INFORMATION
  • ACTIVATION_CONTEXT_SECTION_DLL_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_WINDOW_CLASS_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_COM_PROGID_REDIRECTION
lpStringToFind [in]

Pointer to a null-terminated string to be used as the search criteria.

ReturnedData [out]

Pointer to an ACTCTX_SECTION_KEYED_DATA structure to be filled out with the requested string information.

Return value

If the function succeeds, it returns TRUE. Otherwise, it returns FALSE.

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

This function should only be called by the Side-by-side API functions or COM methods. Applications should not directly call this function.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Winbase.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

Unicode and ANSI names

FindActCtxSectionStringW (Unicode) and FindActCtxSectionStringA (ANSI)

See also

FindActCtxSectionGuid
ACTCTX_SECTION_KEYED_DATA

 

 

Community Additions

ADD
Show:
© 2014 Microsoft