Share via

tapiGetCellularPhoneDevices (Compact 2013)

  • Article

3/26/2014

This function retrieves the cellular phone device IDs.

Syntax

LONG tapiGetCellularPhoneDevices(
  const HPHONEAPP hPhoneApp, 
  const DWORD dwNumberDevices, 
  DWORD* lpdwPhoneDeviceIDs, 
  DWORD* lpdwNumberCelluarDevices
);

Parameters

  • dwNumberDevices
    [in] The number of phone devices available to the application returned by phoneInitializeEx.

  • lpdwPhoneDeviceIDs
    [in] A pointer to a DWORD[dwNumberDevices] long storage area to place the output.

    [out] A pointer to an array of DWORD[dwNumberDevices] phone device IDs.

  • lpdwNumberCelluarDevices
    [in] A pointer to a DWORD storage area to place the output

    [out] The number of devices currently available.

Return Value

This API returns S_OK if the request succeeds or a PHONEERR value otherwise.

Remarks

The number of devices previously returned by phoneInitializeEx may have changed. Therefore, dwNumberDevices may not be equal to lpdwNumberCelluarDevices.

Requirements

Header

astdtapi.h

Library

cellcore.lib

See Also

Reference

Assisted TAPI Functions