Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die lineGetID--Funktion gibt einen Gerätebezeichner für die angegebene Geräteklasse zurück, die der ausgewählten Zeile, Adresse oder dem Anruf zugeordnet ist.
Syntax
LONG lineGetIDA(
HLINE hLine,
DWORD dwAddressID,
HCALL hCall,
DWORD dwSelect,
LPVARSTRING lpDeviceID,
LPCSTR lpszDeviceClass
);
Parameter
hLine
Behandeln eines offenen Leitungsgeräts.
dwAddressID
Adresse auf dem angegebenen offenen Leitungsgerät. Ein Adressbezeichner ist dauerhaft einer Adresse zugeordnet; der Bezeichner bleibt für Betriebssystemupgrades konstant.
hCall
Behandeln eines Anrufs.
dwSelect
Gibt an, ob der angeforderte Gerätebezeichner der Zeile, Adresse oder einem einzelnen Anruf zugeordnet ist. Dieser Parameter verwendet eine und nur eine der LINECALLSELECT_ Konstanten.
lpDeviceID
Zeiger auf einen Speicherspeicherort vom Typ VARSTRING, wobei der Gerätebezeichner zurückgegeben wird. Nach erfolgreichem Abschluss der Anforderung wird dieser Speicherort mit der Geräte-ID gefüllt. Das Format der zurückgegebenen Informationen hängt von der Methode ab, die von der Geräteklassen-API zum Benennen von Geräten verwendet wird. Vor dem Aufrufen lineGetID-muss die Anwendung die dwTotalSize Member dieser Struktur festlegen, um die Menge des verfügbaren Arbeitsspeichers für TAPI zum Zurückgeben von Informationen anzugeben.
Hinweis Wenn die Größenparameter in der Struktur nicht korrekt sind, besteht die Möglichkeit, dass Daten überschrieben werden können. Weitere Informationen zum Festlegen von Strukturgrößen finden Sie im Thema Speicherzuordnung Thema.
lpszDeviceClass
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die die Geräteklasse des Geräts angibt, dessen Bezeichner angefordert wird. Gültige Geräteklassenzeichenfolgen sind diejenigen, die im SYSTEM verwendet werden. INI-Abschnitt zum Identifizieren von Geräteklassen.
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_NOMEM, LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NODEVICE, LINEERR_UNINITIALIZED.
Bemerkungen
Die lineGetID--Funktion kann verwendet werden, um einen Zeilengerätebezeichner abzurufen, wenn ein Linienziehpunkt angegeben wird. Dies ist nützlich, nachdem lineOpen mithilfe von LINEMAPPER als Gerätebezeichner geöffnet wurde, um den tatsächlichen Zeilengerätebezeichner der geöffneten Zeile zu ermitteln. Diese Funktion kann auch verwendet werden, um den Gerätebezeichner eines Telefongeräts oder Mediengeräts (für Geräteklassen wie COM, Wave, MIDI, Telefon, Leitung oder NDIS) abzurufen, die einem Anruf, einer Adresse oder einer Leitung zugeordnet sind. Dieser Bezeichner kann dann mit der entsprechenden API (z. B. Telefon, MIDI, Welle) verwendet werden, um das entsprechende Mediengerät auszuwählen, das dem angegebenen Anruf zugeordnet ist.
Informationen zu Geräteklassennamen finden Sie unter TAPI-Geräteklassen.
Ein Anbieter, der einen gerätespezifischen Medienmodus definiert, muss auch die entsprechende gerätespezifische (proprietäre) API zum Verwalten von Geräten des Medienmodus definieren. Um Konflikte mit Geräteklassennamen zu vermeiden, die unabhängig von verschiedenen Anbietern zugewiesen werden, sollte ein Anbieter einen Namen auswählen, der sowohl den Anbieter als auch den Medientyp eindeutig identifiziert. Beispiel: "intel/video".
Anmerkung
Der Tapi.h-Header definiert lineGetID als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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 |