共用方式為

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 和 Windows XP 搭配 SP1 開始的有效 GUID 區段識別符：
  • 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)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionString