ITLegacyAddressMediaControl2::ConfigDialogEdit-Methode (tapi3if.h)

Die ConfigDialogEdit-Methode bewirkt, dass der Anbieter des angegebenen Leitungsgeräts ein Dialogfeld anzeigt, damit der Benutzer Parameter im Zusammenhang mit dem Leitungsgerät konfigurieren kann. Die Konfigurationsdaten werden von der Anwendung in und aus dieser Methode übergeben. (Die Daten sind identisch mit denen, die von der ITLegacyAddressMediaControl::GetDevConfig-Methode abgerufen und von der ITLegacyAddressMediaControl::SetDevConfig-Methode festgelegt werden.)

Syntax

HRESULT ConfigDialogEdit(
  [in]  HWND  hwndOwner,
  [in]  BSTR  pDeviceClass,
  [in]  DWORD dwSizeIn,
  [in]  BYTE  *pDeviceConfigIn,
  [out] DWORD *pdwSizeOut,
  [out] BYTE  **ppDeviceConfigOut
);

Parameter

[in] hwndOwner

Ein Handle an ein Fenster, an das das Dialogfeld angefügt werden soll. Kann NULL sein, um anzugeben, dass ein von der -Methode erstelltes Fenster kein Besitzerfenster haben sollte.

[in] pDeviceClass

Zeiger auf einen BSTR , der einen Geräteklassennamen angibt. Mit dieser Geräteklasse kann die Anwendung einen bestimmten Unterbildschirm der Konfigurationsinformationen auswählen, die für diese Geräteklasse gelten. Dieser Parameter ist optional und kann NULL oder leer bleiben. In diesem Fall wird die Konfiguration der höchsten Ebene ausgewählt.

[in] dwSizeIn

Zeiger auf die Größe der Konfigurationsdaten, auf die der Parameter pDeviceConfigIn verweist.

[in] pDeviceConfigIn

Zeiger auf ein Bytearray, das die zu bearbeitenden Gerätekonfigurationsdaten enthält.

[out] pdwSizeOut

Zeiger auf die Größe der Konfigurationsdaten, auf die der parameter ppDeviceConfigOut verweist.

[out] ppDeviceConfigOut

Zeiger auf ein Bytearray, das bearbeitete Gerätekonfigurationsdaten enthält.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode wird in eine TAPI 2 übersetzt. xlineConfigDialogEdit-Aufruf . Die ITLegacyAddressMediaControl2::ConfigDialog-Methode wird in einen lineConfigDialog-Aufruf übersetzt. Diese Methoden unterscheiden sich in ihrer Quelle der zu bearbeitenden Parameter und dem Ergebnis der Bearbeitung einer aktiven Verbindung. Eine Erläuterung zu diesen Unterschieden finden Sie unter lineConfigDialogEdit.

Anforderungen

Weitere Informationen

ITLegacyAddressMediaControl2

ITLegacyAddressMediaControl2::ConfigDialog