ITLegacyCallMediaControl::GetID-Methode (tapi3if.h)

Artikel
08/26/2023

Die GetID-Methode ruft den Bezeichner für das Gerät ab, das dem aktuellen Aufruf zugeordnet ist.

Diese Methode ist für C/C++-Anwendungen vorgesehen. Visual Basic- und Skriptanwendungen sollten die METHODE ITLegacyCallMediaControl2::GetIDAsVariant verwenden.

Syntax

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

Parameter

[in] pDeviceClass

Zeiger auf BSTR , der die TAPI-Geräteklasse darstellt.

[out] pdwSize

Größe des Gerätebezeichners in Byte.

[out] ppDeviceID

Gerätebezeichner.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Methode war erfolgreich.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.
E_POINTER	Der PdwSize - oder ppDeviceID-Parameter 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 muss den Arbeitsspeicher freigeben, wenn die Variable nicht mehr benötigt wird.

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