AvSetMmThreadCharacteristicsA-Funktion (avrt.h)
Ordnet den aufrufenden Thread der angegebenen Aufgabe zu.
Syntax
AVRTAPI HANDLE AvSetMmThreadCharacteristicsA(
[in] LPCSTR TaskName,
[in, out] LPDWORD TaskIndex
);
Parameter
[in] TaskName
Der Name der auszuführenden Aufgabe. Dieser Name muss mit dem Namen eines der Unterschlüssel des folgenden Schlüssels HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasksübereinstimmen.
[in, out] TaskIndex
Der eindeutige Aufgabenbezeichner. Wenn diese Funktion zum ersten Mal aufgerufen wird, muss dieser Wert bei der Eingabe 0 sein. Der Indexwert wird bei der Ausgabe zurückgegeben und kann als Eingabe in nachfolgenden Aufrufen verwendet werden.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie ein Handle an die Aufgabe zurück.
Wenn die Funktion fehlschlägt, wird 0 zurückgegeben. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.
Im Folgenden finden Sie mögliche Fehlercodes.
| Rückgabecode | Beschreibung |
|---|---|
|
Entweder ist TaskIndex beim ersten Aufruf nicht 0 oder wird nicht erkannt (bei nachfolgenden Aufrufen). |
|
Die angegebene Aufgabe stimmt mit keiner der in der Registrierung gespeicherten Aufgaben überein. |
|
Der Aufrufer verfügt nicht über ausreichende Berechtigungen. |
Hinweise
Wenn die Aufgabe abgeschlossen ist, rufen Sie die AvRevertMmThreadCharacteristics-Funktion auf.
Hinweis
Der avrt.h-Header definiert AvSetMmThreadCharacteristics als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | avrt.h |
| Bibliothek | Avrt.lib |
| DLL | Avrt.dll |