lineGetAddressIDW-Funktion (tapi.h)

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

Syntax

LONG lineGetAddressIDW(
  HLINE   hLine,
  LPDWORD lpdwAddressID,
  DWORD   dwAddressMode,
  LPCWSTR lpsAddress,
  DWORD   dwSize
);

Parameter

hLine

Behandeln des offenen Leitungsgeräts.

lpdwAddressID

Zeiger auf einen DWORDSpeicherspeicherort der Größe, an dem der Adressbezeichner zurückgegeben wird. Ein Adressbezeichner ist dauerhaft einer Adresse zugeordnet; der Bezeichner bleibt für Betriebssystemupgrades konstant.

dwAddressMode

Adressmodus der Adresse, die in lpsAddressenthalten ist. Dieser Parameter verwendet eine und nur eine der LINEADDRESSMODE_ Konstanten. Sie müssen LINEADDRESSMODE_DIALABLEADDR angeben.

lpsAddress

Zeiger auf eine Datenstruktur, die die Adresse enthält, die dem angegebenen Liniengerät zugewiesen ist. Das Format der Adresse wird durch dwAddressModebestimmt. Da der einzige gültige Wert LINEADDRESSMODE_DIALABLEADDR ist, verwendet lpsAddress das gemeinsame wählbare Nummernformat und ist null-beendet.

dwSize

Größe in Bytes der Adresse, die in lpsAddressenthalten ist. Die Größe der Zeichenfolge muss den Null-Terminator enthalten.

Rückgabewert

Gibt Null zurück, wenn die Anforderung erfolgreich ist oder eine negative Fehlernummer auftritt, 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.

Bemerkungen

Die lineGetAddressID--Funktion wird verwendet, um eine Telefonnummer (Adresse) zuzuordnen, die einem Leitungsgerät zugewiesen ist, zurück zu seinem dwAddressID im Bereich 0 bis zur Anzahl der Adressen minus einer, die in den Gerätefunktionen der Zeile zurückgegeben wird. Mit der lineMakeCall-Funktion kann die Anwendung einen Anruf tätigen, indem sie einen Leitungshandle 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 eine einzelne Zeile mehreren Adressen zugewiesen ist.

Hinweis LINEADDRESSMODE_ADDRESSID kann nicht mit lineGetAddressID-verwendet werden.

 

Anmerkung

Der header tapi.h definiert lineGetAddressID als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	tapi.h
Library	Tapi32.lib
DLL-	Tapi32.dll

Siehe auch

Referenz zu grundlegenden Telefoniediensten

TAPI 2.2 Referenzübersicht

lineMakeCall-