CreateActCtxA 函式（winbase.h）

CreateActCtx 函式會建立啟用內容。

語法

HANDLE CreateActCtxA(
  [in, out] PCACTCTXA pActCtx
);

[in, out] pActCtx

ACTCTX 結構的指標，其中包含要建立之啟用內容的相關信息。

如果函式成功，它會將句柄傳回給傳回的啟用內容。否則，它會傳回INVALID_HANDLE_VALUE。

此函式會設定可藉由呼叫 getLastError擷取的錯誤。如需範例，請參閱擷取 Last-Error 程式代碼。如需錯誤碼的完整清單，請參閱系統錯誤碼。

將 ACTCTX dwFlags 中的任何未定義位設定為 0。如果未將任何未定義的位設定為 0，則呼叫 createActCtx 建立啟用內容時會失敗，並傳回無效的參數錯誤碼。從 createActCtx 傳回的句柄會傳遞至 activateActCtx ，以啟動目前線程的內容。

注意

winbase.h 標頭會將 CreateActCtx 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。