Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function is obsolete. TAPI 1.4 or earlier service providers can implement this TSPI function.

The TSPI_phoneConfigDialogfunction causes the provider of the specified phone device to display a modal dialog box as a child window of hwndOwnerto allow the user to configure parameters related to the phone device.

Syntax 

LONG TSPIAPI TSPI_phoneConfigDialog(
  DWORD 
dwDeviceID, 
  HWND 
hwndOwner, 
  LPCWSTR 
lpszDeviceClass 
);

Parameters

dwDeviceID

Phone device to be configured.

hwndOwner

Handle to a parent window in which the dialog box window is to be placed.

lpszDeviceClass

Pointer to a null-terminated Unicode string that identifies a device class name. This device class allows the caller to select a specific subscreen of configuration information applicable to that device class. If this parameter is NULL or an empty string, the highest level configuration dialog box is selected.

Return Value

Returns zero if the function succeeds, or an error number if an error occurs. The following table shows the return values for this method.

Value Description

PHONEERR_BADDEVICEID

The device id is incorrect.

PHONEERR_NOMEM

Not enough memory is available.

PHONEERR_INUSE

The phone is in use.

PHONEERR_OPERATIONFAILED

The operation failed.

PHONEERR_INVALPARAM

The parameter is invalid.

PHONEERR_OPERATIONUNAVAIL

The operation is unavailable.

PHONEERR_INVALDEVICECLASS

The device class is invalid.

PHONEERR_RESOURCEUNAVAIL

The resource is unavailable.

Remarks

TSPI_phoneConfigDialogcauses the service provider to display a modal dialog box as a child window of hWndOwnerto allow the user to configure parameters related to the phone specified by dwDeviceID. The lpszDeviceClassparameter allows the application to select a specific subscreen of configuration information applicable to the device class in which the user is interested. The permitted strings are the same as for the TSPI_phoneGetIDfunction. The szDeviceClassparameter should be "tapi/phone", "", or NULL to cause the provider to display the highest level configuration for the phone.

Requirements

Header tapicomn.h
Library coredll.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

TSPI_phoneGetID