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。

以下是可能的錯誤碼。

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

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

注意

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