funzione lineGetAgentStatusA (tapi.h)
La funzione lineGetAgentStatus ottiene lo stato correlato all'agente nell'indirizzo specificato.
Sintassi
LONG lineGetAgentStatusA(
HLINE hLine,
DWORD dwAddressID,
LPLINEAGENTSTATUS lpAgentStatus
);
Parametri
hLine
Gestire 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 definitivamente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.
lpAgentStatus
Puntatore a una struttura di dimensioni variabile del tipo LINEAGENTSTATUS. Al termine della richiesta, questa struttura viene riempita 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 restituire 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.
Commenti
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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |