lineGetAddressStatus

  • 项目

This function allows an application to query the specified address for its current status.

Note   This function is for TAPI version 2.0 and later.

LONG WINAPI lineGetAddressStatus(
  HLINE hLine,
  DWORD dwAddressID,
  LPLINEADDRESSSTATUS lpAddressStatus 
);

Parameters

  • hLine
    Handle to the open line device.
  • dwAddressID
    Address on the given open line device. This is the address to be queried. An address identifier is permanently associated with an address; the identifier remains constant across operating system upgrades.
  • lpAddressStatus
    Pointer to a variably sized data structure of type LINEADDRESSSTATUS. Prior to calling lineGetAddressStatus, the application should set the dwTotalSize member of this structure to indicate the amount of memory available to TAPI for returning information.

Return Values

Returns zero if the request succeeds or a negative error number if an error occurs. The following table shows the return values for this function.

Value Description
LINEERR_INVALADDRESSID The address identifier is invalid.
LINEERR_RESOURCEUNAVAIL The resources are unavailable.
LINEERR_INVALLINEHANDLE The handle to the open line device is invalid.
LINEERR_STRUCTURETOOSMALL The structure is too small.
LINEERR_INVALPOINTER The pointer is invalid.
LINEERR_UNINITIALIZED A parameter is uninitialized.
LINEERR_NOMEM Not enough memory is available.
LINEERR_OPERATIONUNAVAIL The operation is unavailable.
LINEERR_OPERATIONFAILED The operation failed.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Tapi.h.
Link Library: Coredll.lib.

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.