phoneGetStatus
The phoneGetStatus
function enables an application to query the specified open phone device for
its overall status.
LONG phoneGetStatus(
|
HPHONE hPhone, |
|
|
LPPHONESTATUS lpPhoneStatus |
|
|
); |
|
Parameters
hPhone
A handle to
the open phone device to be queried.
lpPhoneStatus
A pointer to
a variably sized data structure of type PHONESTATUS, which is loaded with the
returned information about the phone's status.
Return Values
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_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL,
PHONEERR_OPERATIONFAILED, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL,
PHONEERR_UNINITIALIZED.
Remarks
An
application can use this function to determine the current state of an open
phone device. The status information describes information about the phone
device's hookswitch devices, ringer, volume, display, and lamps of the open
phone.
See Also