funzione lineGetAgentStatusA (tapi.h)

Articolo
08/26/2023

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.

Nota Se i parametri delle dimensioni nella struttura non sono corretti, è possibile che la memoria possa essere sovrascritta. Per altre informazioni sull'impostazione delle dimensioni della struttura, vedere l'argomento relativo all'allocazione della memoria .

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.