通过

FindActCtxSectionStringW 函数 （winbase.h）

  • 项目

FindActCtxSectionString 函数检索当前激活上下文中特定字符串的信息，并返回 ACTCTX_SECTION_KEYED_DATA 结构。

语法

BOOL FindActCtxSectionStringW(
  [in]  DWORD                      dwFlags,
  [in]  const GUID                 *lpExtensionGuid,
  [in]  ULONG                      ulSectionId,
  [in]  LPCWSTR                    lpStringToFind,
  [out] PACTCTX_SECTION_KEYED_DATA ReturnedData
);

参数

[in] dwFlags

确定此函数如何操作的标志。 目前仅定义了以下标志。

价值 意义
FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX
 此函数返回激活上下文句柄，该句柄在 ACTCTX_SECTION_KEYED_DATA 结构的 hActCtx 成员中找到重定向数据。 调用方必须使用 ReleaseActCtx 来发布此激活上下文。

[in] lpExtensionGuid

保留;必须为 null。

[in] ulSectionId

要在其中搜索特定字符串的激活上下文的字符串部分的标识符。

下面是有效的字符串节标识符：

  • ACTIVATION_CONTEXT_SECTION_ASSEMBLY_INFORMATION
  • ACTIVATION_CONTEXT_SECTION_DLL_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_WINDOW_CLASS_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_COM_PROGID_REDIRECTION

[in] lpStringToFind

指向要用作搜索条件的以 null 结尾的字符串的指针。

[out] ReturnedData

指向要用请求的字符串信息填充的 ACTCTX_SECTION_KEYED_DATA 结构的指针。

返回值

如果函数成功，则返回 TRUE。 否则，它将返回 FALSE。

此函数设置可以通过调用 GetLastError来检索的错误。 有关示例，请参阅 检索 Last-Error 代码。 有关错误代码的完整列表，请参阅 系统错误代码。

言论

此函数只能由并行 API 函数或 COM 方法调用。 应用程序不应直接调用此函数。

注意

winbase.h 标头将 FindActCtxSectionString 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 winbase.h （包括 Windows.h）
库 Kernel32.lib
DLL Kernel32.dll

另请参阅

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionGuid