Metodo ITLegacyCallMediaControl::GetID (tapi3if.h)

Articolo
08/26/2023

Il metodo GetID ottiene l'identificatore per il dispositivo associato alla chiamata corrente.

Questo metodo è destinato alle applicazioni C/C++. Le applicazioni visual Basic e di scripting devono usare il metodo ITLegacyCallMediaControl2::GetIDAsVariant .

Sintassi

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

Parametri

[in] pDeviceClass

Puntatore a BSTR che rappresenta la classe del dispositivo TAPI.

[out] pdwSize

Dimensioni in byte dell'identificatore del dispositivo.

[out] ppDeviceID

Identificatore del dispositivo.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.
E_POINTER	Il parametro pdwSize o ppDeviceID non è un puntatore valido.

Commenti

L'applicazione deve chiamare ITTAPI::RegisterCallNotifications prima di chiamare questo metodo.

L'applicazione deve usare SysAllocString per allocare memoria per il parametro pDeviceClass e usare SysFreeString per liberare la memoria quando la variabile non è più necessaria.

L'applicazione deve chiamare la funzione CoTaskMemFree per liberare la memoria allocata per il parametro ppDeviceID .