lineGetAddressID-Funktion (tapi.h)

Artikel
03/04/2024

Die funktion lineGetAddressID gibt den Adressbezeichner zurück, der einer Adresse in einem anderen Format in der angegebenen Zeile zugeordnet ist.

Syntax

LONG lineGetAddressID(
  HLINE   hLine,
  LPDWORD lpdwAddressID,
  DWORD   dwAddressMode,
  LPCSTR  lpsAddress,
  DWORD   dwSize
);

Parameter

hLine

Handle mit dem open line-Gerät.

lpdwAddressID

Zeiger auf einen Speicherspeicherort im DWORD-Format, an dem der Adressbezeichner zurückgegeben wird. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet. Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.

dwAddressMode

Der Adressmodus der in lpsAddress enthaltenen Adresse. Dieser Parameter verwendet nur eine der LINEADDRESSMODE_ Konstanten. Sie müssen LINEADDRESSMODE_DIALABLEADDR angeben.

lpsAddress

Zeiger auf eine Datenstruktur mit der Adresse, die dem angegebenen Zeilengerät zugewiesen ist. Das Format der Adresse wird durch dwAddressMode bestimmt. Da der einzige gültige Wert LINEADDRESSMODE_DIALABLEADDR ist, verwendet lpsAddress das allgemeine Format für die wählbare Zahl und ist null-beendet.

dwSize

Größe der adresse in lpsAddress. Die Größe der Zeichenfolge muss den NULL-Abschlussator enthalten.

Rückgabewert

Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Hinweise

Die lineGetAddressID-Funktion wird verwendet, um eine Telefonnummer (Adresse), die einem Leitungsgerät zugewiesen ist, der dwAddressID im Bereich null der Anzahl der Adressen minus 1 zuzuordnen, die in den Gerätefunktionen der Zeile zurückgegeben werden. Mit der lineMakeCall-Funktion kann die Anwendung einen Aufruf tätigen, indem sie ein Zeilenhandle und eine Adresse in der Zeile angibt. Die Adresse kann als dwAddressID, als Telefonnummer oder als gerätespezifischer Name oder Bezeichner angegeben werden. Die Verwendung einer Telefonnummer kann in Umgebungen praktisch sein, in denen einer einzelnen Zeile mehrere Adressen zugewiesen werden.

Hinweis LINEADDRESSMODE_ADDRESSID dürfen nicht mit lineGetAddressID verwendet werden.