共用方式為

FindActCtxSectionStringA 函式 （winbase.h）

  • 發行項

FindActCtxSectionString 函式會擷取目前啟用內容中特定字串串的相關信息，並傳回 ACTCTX_SECTION_KEYED_DATA 結構。

語法

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

參數

[in] dwFlags

決定此函式運作方式的旗標。 目前只會定義下列旗標。

價值 意義
FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX
 此函式會傳回在 hActCtx 結構 ACTCTX_SECTION_KEYED_DATA 成員中找到重新導向數據的啟用內容句柄。 呼叫端必須使用 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 標頭會根據 UNICODE 預處理器常數的定義，將 FindActCtxSectionString 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 winbase.h （包括 Windows.h）
連結庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionGuid