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
決定此函式運作方式的旗標。 目前只會定義下列旗標。
| 值 | 意義 |
|---|---|
|
此函式會傳回在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 |