FindActCtxSectionGuid 函数 (winbase.h)

FindActCtxSectionGuid 函数检索有关当前激活上下文中特定 GUID 的信息,并返回ACTCTX_SECTION_KEYED_DATA结构。

语法

BOOL FindActCtxSectionGuid(
  [in]  DWORD                      dwFlags,
  [in]  const GUID                 *lpExtensionGuid,
  [in]  ULONG                      ulSectionId,
  [in]  const GUID                 *lpGuidToFind,
  [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

要在其中搜索指定 GUID 的激活上下文部分的标识符。

下面是有效的 GUID 节标识符:

  • ACTIVATION_CONTEXT_SECTION_COM_SERVER_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_COM_INTERFACE_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_COM_TYPE_LIBRARY_REDIRECTION
下面是从 Windows Server 2003 开始的有效 GUID 节标识符和 SP1 的 Windows XP:
  • ACTIVATION_CONTEXT_SECTION_CLR_SURROGATES

[in] lpGuidToFind

指向要用作搜索条件的 GUID 的指针。

[out] ReturnedData

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

返回值

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

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

注解

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

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 winbase.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionString