lineGetGeneralInfo

Send Feedback

Use the lineGetGeneralInfo function to retrieve general device information about the radio hardware, the radio software, the serial number, subscriber identity, and other information.

LONG WINAPI lineGetGeneralInfo(
  HLINE hLine,
  LPLINEGENERALINFO lpLineGeneralInfo
);

Parameters

  • hLine
    The line device handle. The line device handle must have been previously obtained by a call to lineOpen with the proper TAPI device ID specified and a device-specific extension version successfully negotiated with lineNegotiateExtVersion. For more information about lineNegotiateExtVersion and lineOpen, see the TAPI Functions API Reference topics on MSDN.
  • lpLineGeneralInfo
    Points to a LINEGENERALINFO structure that provides information about the radio module manufacturer, version number, and other information.

Return Values

Returns zero if the function completes successfully, or a negative error number if an error occurs. The following are possible return values:

LINEERR_RESOURCEUNAVAIL
LINEERR_INVALLINEHANDLE
LINEERR_STRUCTURETOOSMALL
LINEERR_INVALPOINTER
LINEERR_UNINITIALIZED
LINEERR_NOMEM
LINEERR_OPERATIONUNAVAIL
LINEERR_OPERATIONFAILED

Remarks

This function is synchronous. No LINE_REPLY message is sent.

The support for this function varies on CDMA devices. For lineGetGeneralInfo to complete successfully on a CDMA device, the device's RIL driver must support the RIL_GetUserIdentity and RIL_GetEquipmentInfo functions.

This function can be used to retrieve the Electronic Serial Number (ESN) from a CDMA device. Typically, the ESN is part of the LINEGENERALINFO structure and is represented as an eight digit hexadecimal number beginning at the dwSerialNumberOffset.

This is a privileged function. For more information about Smartphone security and privileged APIs, see the "Operating System Security" topic in the Windows Mobile Adaptation Kit.

Requirements

Pocket PC: Pocket PC 2002 and later.
Smartphone: Smartphone 2002 and later.
OS Versions: Windows CE 3.0 and later.
Header: Extapi.h.
Library: Cellcore.lib.

See Also

Extended TAPI Functions | LINEGENERALINFO

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.