ITLegacyAddressMediaControl2::ConfigDialogEdit method (tapi3if.h)
The ConfigDialogEdit method causes the provider of the specified line device to display a dialog box to allow the user to configure parameters related to the line device. The configuration data is passed in and out of this method by the application. (The data is the same as that retrieved by the ITLegacyAddressMediaControl::GetDevConfig method and set by the ITLegacyAddressMediaControl::SetDevConfig method.)
HRESULT ConfigDialogEdit( HWND hwndOwner, BSTR pDeviceClass, DWORD dwSizeIn, BYTE *pDeviceConfigIn, DWORD *pdwSizeOut, BYTE **ppDeviceConfigOut );
A handle to a window to which the dialog box is to be attached. Can be NULL to indicate that a window created by the method should have no owner window.
Pointer to a BSTR that specifies a device class name. This device class allows the application to select a specific subscreen of configuration information applicable to that device class. This parameter is optional and can be left NULL or empty, in which case the highest level configuration is selected.
Pointer to the size of the configuration data pointed to by the pDeviceConfigIn parameter.
Pointer to an array of bytes containing device configuration data to edit.
Pointer to the size of the configuration data pointed to by the ppDeviceConfigOut parameter.
Pointer to an array of bytes containing edited device configuration data.
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
This method translates to a TAPI 2.x lineConfigDialogEdit call. The ITLegacyAddressMediaControl2::ConfigDialog method translates to a lineConfigDialog call. These methods differ in their source of parameters to edit and the result of the editing on an active connection. For a discussion about these differences, see lineConfigDialogEdit.