ITLegacyAddressMediaControl::GetID-Methode (tapi3if.h)

Artikel
08/26/2023

Die GetID-Methode gibt einen Gerätebezeichner für die angegebene Geräteklasse zurück, die der aktuellen Adresse zugeordnet ist.

Diese Methode ist nur für C/C++-Anwendungen vorgesehen. Für Visual Basic- und Skriptanwendungen ist keine entsprechende Methode verfügbar.

Syntax

HRESULT GetID(
  [in]  BSTR  pDeviceClass,
  [out] DWORD *pdwSize,
  [out] BYTE  **ppDeviceID
);

Parameter

[in] pDeviceClass

Zeiger auf BSTR mit TAPI-Geräteklasse , für die Konfigurationsinformationen benötigt werden.

[out] pdwSize

Länge des zurückgegebenen Gerätebezeichners.

[out] ppDeviceID

Gerätebezeichner.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Methode war erfolgreich.
E_FAIL	Fehler bei der Methode. Dies kann bedeuten, dass der aktuellen Adresse kein Gerät einer angegebenen Klasse zugeordnet ist.
E_POINTER	Der Parameter pdwSize oder ppDeviceID ist kein gültiger Zeiger.

Hinweise

Die Anwendung muss ITTAPI::RegisterCallNotifications aufrufen, bevor diese Methode aufgerufen wird.

Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für den pDeviceClass-Parameter zuzuweisen und SysFreeString zum Freigeben des Arbeitsspeichers verwenden, wenn die Variable nicht mehr benötigt wird.

Die Anwendung muss die CoTaskMemFree-Funktion aufrufen, um den für den ppDeviceID-Parameter zugewiesenen Arbeitsspeicher freizugeben.

TAPI 2.1 Cross-References: lineGetDevConfig, lineSetDevConfig, lineGetID