TSPI_lineGetAddressID-Funktion (tspi.h)
Die funktion TSPI_lineGetAddressID gibt den Adressbezeichner zurück, der der Adresse in einem anderen Format in der angegebenen Zeile zugeordnet ist.
Syntax
LONG TSPIAPI TSPI_lineGetAddressID(
HDRVLINE hdLine,
LPDWORD lpdwAddressID,
DWORD dwAddressMode,
LPCWSTR lpsAddress,
DWORD dwSize
);
Parameter
hdLine
Das Handle des Dienstanbieters für die Zeile, deren Adresse abgerufen werden soll.
lpdwAddressID
Ein Zeiger auf einen Speicherort im DWORD-Format, an dem der Adressbezeichner zurückgegeben wird.
dwAddressMode
Der Adressmodus der in lpsAddress enthaltenen Adresse. Der dwAddressMode-Parameter darf nur eine der LINEADDRESSMODE_ Konstanten aufweisen.
lpsAddress
Ein Zeiger auf eine Datenstruktur mit der Adresse, die dem angegebenen Leitungsgerät zugewiesen ist. Das Format der Adresse wird durch den dwAddressMode-Parameter bestimmt. Wenn es LINEADDRESSMODE_DIALABLEADDR ist, verwendet der lpsAddress-Parameter das allgemeine wählbare Nummernformat und ist NULL beendet.
dwSize
Die Größe der in lpsAddress enthaltenen Adresse. Der DwSize-Parameter muss auf die Länge der Zeichenfolge (plus eins für NULL) festgelegt werden, wenn LINEADDRESSMODE_DIALABLEADDR verwendet wird. Wenn ein erweiterter LINEADDRESSMODE-Modus verwendet wird, sollte die Länge mit der Größe des tatsächlich übergebenen Elements übereinstimmen (die DLL überprüft, um sicherzustellen, dass sie die Anzahl von Bytes lesen kann, die vom angegebenen Zeiger angegeben wurde).
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Hinweise
Diese Funktion wird verwendet, um eine Telefonnummer (Adresse), die einem Leitungsgerät zugewiesen ist, seiner dwAddressID (im Bereich von 0 bis zur Anzahl der Adressen minus 1) zuzuordnen, die in den Gerätefunktionen der Leitung zurückgegeben wird.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tspi.h |