Platform SDK: TAPI

ITLegacyAddressMediaControl::GetID

The GetID method returns a device identifier for the specified device class associated with the current address.

HRESULT GetID(
  BSTR pDeviceClass,
  DWORD *pdwSize,
  BYTE **ppDeviceID
);

Parameters

pDeviceClass
[in] Pointer to BSTR containing TAPI device class for which configuration information is needed.
pdwSize
[out] Length of device identifier returned.
ppDeviceID
[out, size_is(,*pdwSize)] Device identifier.

Return Values

Value Meaning
S_OK Method succeeded.
E_FAIL Method failed. This may mean there is no device of a specified class associated with the current address.
E_POINTER The pdwSize or ppDeviceID parameter is not a valid pointer.

Remarks

The application must use SysAllocString to allocate memory for the pDeviceClass parameter and use SysFreeString to free the memory when the variable is no longer needed.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

ITLegacyAddressMediaControl, GetDevConfig, SetDevConfig, ITLegacyCallMediaControl

TAPI 2.1 Cross-reference: LineGetDevConfig, LineSetDevConfig, lineGetID