Metodo ITLegacyAddressMediaControl::GetID (tapi3if.h)

Articolo
03/08/2023

Il metodo GetID restituisce un identificatore del dispositivo per la classe di dispositivo specificata associata all'indirizzo corrente.

Questo metodo è destinato solo alle applicazioni C/C++. Non è disponibile alcun metodo corrispondente per le applicazioni visual basic e di scripting.

Sintassi

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

Parametri

[in] pDeviceClass

Puntatore a BSTR contenente la classe di dispositivo TAPI per cui sono necessarie informazioni di configurazione.

[out] pdwSize

Lunghezza dell'identificatore del dispositivo restituito.

[out] ppDeviceID

Identificatore del dispositivo.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_FAIL	Metodo non riuscito. Ciò potrebbe significare che non esiste alcun dispositivo di una classe specificata associata all'indirizzo corrente.
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 .

TAPI 2.1 Riferimenti incrociati: lineGetDevConfig, lineSetDevConfig, lineGetID