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
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |