phoneClose
A version of this page is also available for
4/8/2010
This function closes the specified open phone device.
Syntax
LONG WINAPI phoneClose(
HPHONE hPhone
);
Parameters
- hPhone
Handle to the open phone device to be closed. If the function succeeds, the handle is no longer valid.
Return Value
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. |
Remarks
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.
Note
This function is for TAPI version 2.0 and later.
Requirements
| Header | tapi.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |