共用方式為

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
 此函式會傳回在ACTCTX_SECTION_KEYED_DATA結構的hActCtx成員中找到重新導向資料的啟用內容控制碼。 呼叫端必須使用 ReleaseActCtx 來釋放此啟用內容。

[in] lpExtensionGuid

保留;必須是 Null。

[in] ulSectionId

要在其中搜尋特定字串之啟用內容之字串區段的識別碼。

以下是有效的字串區段識別碼：

  • ACTI加值稅ION_CONTEXT_SECTION_ASSEMBLY_INFORMATION
  • ACTI加值稅ION_CONTEXT_SECTION_DLL_REDIRECTION
  • ACTI加值稅ION_CONTEXT_SECTION_WINDOW_CLASS_REDIRECTION
  • ACTI加值稅ION_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 [僅限傳統型應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionGuid