phoneClose

phoneClose (Compact 2013)

3/26/2014

This function closes the specified open phone device.


LONG WINAPI phoneClose(
  HPHONE hPhone 
);

hPhone

Handle to the open phone device to be closed. If the function succeeds, the handle is no longer valid.

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

PHONEERR_INVALPHONEHANDLE

The handle to the open phone device is invalid.

PHONEERR_NOMEM

Not enough memory is available.

PHONEERR_OPERATIONFAILED

The operation failed.

PHONEERR_RESOURCEUNAVAIL

The resources are unavailable.

PHONEERR_OPERATIONUNAVAIL

The operation is unavailable.

PHONEERR_UNINITIALIZED

The parameter is uninitialized.

After the open phone device has been successfully closed, the implementation sends a PHONE_CLOSE message to the application. These messages can also be sent unsolicited as a result of the phone device being reclaimed somehow. An application should therefore be prepared to handle these unsolicited close messages. At the time the phone device is closed, any outstanding asynchronous replies are suppressed.

Header

tapi.h

Library

TAPI32.dll

Show:
© 2016 Microsoft