Platform SDK: TAPI

ITLegacyCallMediaControl::GetID

Gets identifier for the device associated with the current call.

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

Parameters

pDeviceClass: [in] Pointer to BSTR representing the TAPI device class.
pdwSize: [out] Size in bytes of device identifier.
ppDeviceID: [out, size_is(,*pdwSize)] Device identifier.

Return Values

Value	Meaning
S_OK	Method succeeded.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.
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.

ITLegacyCallMediaControl::GetID

Parameters

Return Values

Remarks

Requirements

See Also