AvSetMmThreadCharacteristicsA 函式（avrt.h）

將呼叫線程與指定的工作產生關聯。

語法

AVRTAPI HANDLE AvSetMmThreadCharacteristicsA(
  [in]      LPCSTR  TaskName,
  [in, out] LPDWORD TaskIndex
);

[in] TaskName

要執行的工作名稱。此名稱必須符合下列其中一個索引鍵的子機碼名稱，HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasks。

[in, out] TaskIndex

唯一的工作標識碼。第一次呼叫此函式時，這個值在輸入上必須是 0。索引值會在輸出上傳回，而且可在後續呼叫中當做輸入使用。

如果函式成功，它會傳回工作的句柄。

如果函式失敗，則會傳回 0。若要擷取擴充的錯誤資訊，請呼叫 GetLastError。

以下是可能的錯誤碼。

傳回碼	描述
ERROR_INVALID_TASK_INDEX	TaskIndex 在第一次呼叫時不是 0，或是在後續呼叫時無法辨識值。
ERROR_INVALID_TASK_NAME	指定的工作不符合登錄中儲存的任何工作。
ERROR_PRIVILEGE_NOT_HELD	呼叫端沒有足夠的許可權。

當工作完成時，請呼叫 AvRevertMmThreadCharacteristics 函式。

注意

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