Funzione lineSetAgentStateEx (tapi.h)
La funzione lineSetAgentStateEx imposta lo stato dell'agente associato a un handle di agente specifico. Genera un messaggio di LINE_PROXYREQUEST da inviare a un gestore di funzioni proxy registrato, facendo riferimento a una struttura LINEPROXYREQUEST di tipo LINEPROXYREQUEST_SETAGENTSTATEEX.
Sintassi
LONG lineSetAgentStateEx(
HLINE hLine,
HAGENT hAgent,
DWORD dwAgentState,
DWORD dwNextAgentState
);
Parametri
hLine
Handle per il dispositivo line.
hAgent
Identificatore dell'agente le cui informazioni devono essere modificate.
dwAgentState
Nuovo stato dell'agente. Deve essere una delle costanti LINEAGENTSTATEEX_ oppure zero per lasciare invariato lo stato dell'agente e modificare solo lo stato successivo.
dwNextAgentState
Stato successivo dell'agente. Deve essere una delle costanti LINEAGENTSTATEEX_ o zero.
Valore restituito
Restituisce un identificatore di richiesta se l'operazione asincrona viene avviata; in caso contrario, la funzione restituisce uno dei valori di errore seguenti:
LINEERR_INVALAGENTSTATE, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL LINEERR_UNINITIALIZED.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |