Funzione AvSetMmThreadCharacteristicsA (avrt.h)
Associa il thread chiamante all'attività specificata.
Sintassi
AVRTAPI HANDLE AvSetMmThreadCharacteristicsA(
[in] LPCSTR TaskName,
[in, out] LPDWORD TaskIndex
);
Parametri
[in] TaskName
Nome dell'attività da eseguire. Questo nome deve corrispondere al nome di una delle sottochiavi della chiave seguente HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Multimedia\SystemProfile\Tasks.
[in, out] TaskIndex
Identificatore univoco dell'attività. La prima volta che questa funzione viene chiamata, questo valore deve essere 0 all'input. Il valore di indice viene restituito nell'output e può essere usato come input nelle chiamate successive.
Valore restituito
Se la funzione ha esito positivo, restituisce un handle all'attività.
Se la funzione ha esito negativo, restituisce 0. Per recuperare informazioni sull'errore estese, chiamare GetLastError.
Di seguito sono riportati i possibili codici di errore.
| Codice restituito | Descrizione |
|---|---|
|
TaskIndex non è 0 nella prima chiamata o non è riconosciuto (nelle chiamate successive). |
|
L'attività specificata non corrisponde ad alcuna attività archiviata nel Registro di sistema. |
|
Il chiamante non dispone di privilegi sufficienti. |
Commenti
Al termine dell'attività, chiamare la funzione AvRevertMmThreadCharacteristics .
Nota
L'intestazione avrt.h definisce AvSetMmThreadCharacteristics come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | avrt.h |
| Libreria | Avrt.lib |
| DLL | Avrt.dll |