MprAdminInterfaceDeviceSetInfo-Funktion (mprapi.h)

  • Artikel

MprAdminInterfaceDeviceSetInfo erstellt oder ändert ein Gerät, das in einer Router-Schnittstelle für Bedarfswählvorgänge verwendet wird.

Syntax

DWORD MprAdminInterfaceDeviceSetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwIndex,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

Parameter

[in] hMprServer

Verarbeiten Sie den Router, auf dem dieser Aufruf ausgeführt werden soll. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect aufrufen.

[in] hInterface

Handle mit der Schnittstelle. Rufen Sie dieses Handle aus einem vorherigen Aufruf von MprAdminInterfaceCreate oder durch Aufrufen von MprAdminInterfaceEnum ab.

[in] dwIndex

Gibt den 1-basierten Index des Geräts an. Eine multiverknüpfte Bedarfswahlschnittstelle verwendet mehrere Geräte.

[in] dwLevel

Ein DWORD-Wert, der das Format beschreibt, in dem die Informationen im lplpBuffer-Parameter strukturiert sind. Zulässige Werte für dwLevel umfassen 0 oder 1, wie in der folgenden Tabelle aufgeführt.

Wert Strukturformat
0 MPR_DEVICE_0
1 MPR_DEVICE_1

[in] lpbBuffer

Ein Zeiger auf eine MPR_DEVICE_0- oder MPR_DEVICE_1-Struktur . Der dwLevel-Parameter gibt den Typ der Struktur an.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert Bedeutung
ERROR_ACCESS_DENIED
 Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen.
ERROR_INVALID_HANDLE
 Der hInterface-Wert ist ungültig.
ERROR_INVALID_PARAMETER
 Der lplpBuffer-Parameter ist NULL.
ERROR_NOT_ENOUGH_MEMORY
 Unzureichende Ressourcen, um den Vorgang abzuschließen.
ERROR_NOT_SUPPORTED
 Der dwLevel-Wert ist ungültig.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mprapi.h
Bibliothek Mprapi.lib
DLL Mprapi.dll

Weitere Informationen

MPR_DEVICE_0

MPR_DEVICE_1

MprAdminInterfaceCreate

MprAdminInterfaceDeviceGetInfo