Funzione lineGetAgentStatusA (tapi.h)
La funzione lineGetAgentStatus ottiene lo stato correlato all'agente sull'indirizzo specificato.
Sintassi
LONG lineGetAgentStatusA(
HLINE hLine,
DWORD dwAddressID,
LPLINEAGENTSTATUS lpAgentStatus
);
Parametri
hLine
Handle per il dispositivo a riga aperta.
dwAddressID
Indirizzo nel dispositivo a riga aperta il cui stato dell'agente deve essere sottoposto a query. Un identificatore di indirizzo è associato in modo permanente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.
lpAgentStatus
Puntatore a una struttura di dimensioni variabili di tipo LINEAGENTSTATUS. Al termine della richiesta, questa struttura viene compilata con informazioni sullo stato dell'agente. Prima di chiamare lineGetAgentStatus, l'applicazione deve impostare il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per la restituzione di informazioni.
Valore restituito
Restituisce un identificatore di richiesta positivo se l'operazione asincrona viene avviata; in caso contrario, uno dei valori di errore negativi seguenti:
LINEERR_INVALADDRESSID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.
Osservazioni
Nota
L'intestazione tapi.h definisce lineGetAgentStatus 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Finestre |
| intestazione |
tapi.h |
| libreria |
Tapi32.lib |
| dll | Tapi32.dll |