MprAdminInterfaceDeviceSetInfo-Funktion (mprapi.h)
MprAdminInterfaceDeviceSetInfo erstellt oder ändert ein Gerät, das in einer Router-Schnittstelle für Bedarfswählvorgänge verwendet wird.
DWORD MprAdminInterfaceDeviceSetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwIndex,
[in] DWORD dwLevel,
[in] LPBYTE lpbBuffer
);
[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.
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 |
---|---|
|
Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen. |
|
Der hInterface-Wert ist ungültig. |
|
Der lplpBuffer-Parameter ist NULL. |
|
Unzureichende Ressourcen, um den Vorgang abzuschließen. |
|
Der dwLevel-Wert ist ungültig. |
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 |