ITPhone::Close method (tapi3if.h)
The Close method closes this phone device. The phone device remains closed until the application calls the ITPhone::Open method. For more information, see the following Remarks section.
This method is analogous to the TAPI 2.x phoneOpen function; please see the TAPI 2.x documentation for more information.
Syntax
HRESULT Close();
Return value
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
While a phone is closed, the application does not receive events pertaining to the phone.
A phone must be open with owner privilege for the application to set the state of the phone. Querying the state of the phone can typically be done even if the phone is not open; for more details, see the individual methods of the ITPhone interface.
After the phone device has been successfully closed, any ITAutomatedPhoneControl interface pointer obtained for this phone object is no longer valid.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | tapi3if.h (include Tapi3.h) |
| Library | Uuid.lib |
| DLL | Tapi3.dll |