function closes the specified open phone device.
A handle to the open phone device to be closed. If the function is successful,
the handle is no longer valid.
Returns zero if the request is successful or a negative error number if an
error has occurred. Possible return values are:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_OPERATIONFAILED,
PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.
After the open phone device has been successfully closed, the implementation
sends a PHONE_CLOSE message to the application. Note that 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.
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages