ITLegacyAddressMediaControl::SetDevConfig-Methode (tapi3if.h)

Artikel
03/04/2024

Die SetDevConfig-Funktion ermöglicht es der Anwendung, die Konfiguration eines Medienstreamgeräts auf einem Leitungsgerät in einem Setup wiederherzustellen, das zuvor mit GetDevConfig abgerufen wurde.

Syntax

HRESULT SetDevConfig(
  [in] BSTR  pDeviceClass,
  [in] DWORD dwSize,
  [in] BYTE  *pDeviceConfig
);

Parameter

[in] pDeviceClass

Zeiger auf BSTR , der die TAPI-Geräteklasse enthält, für die Konfigurationsinformationen benötigt werden.

[in] dwSize

Größe des Konfigurationsarrays.

[in] pDeviceConfig

Zeiger auf das Bytearray, das Gerätekonfigurationsinformationen enthält, die durch einen Aufruf von GetDevConfig abgerufen wurden.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Methode war erfolgreich.
E_POINTER	Der Parameter pDeviceClass, pdwSize oder ppDeviceConfig ist kein gültiger Zeiger.
E_INVALIDARG	Der pdwSize-Parameter ist null.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.

Hinweise

Diese Methode ist ein COM-Wrapper für die TAPI 2.1-Funktion lineSetDevConfig .

Die GetID muss vor dem Aufrufen dieser Methode ausgeführt werden.

Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für den pDeviceClass-Parameter zuzuweisen, und SysFreeString muss den Arbeitsspeicher freigeben, wenn die Variable nicht mehr benötigt wird.

TAPI 2.1 Querverweise: lineGetDevConfig, lineSetDevConfig