Freigeben über


MprConfigServerGetInfo-Funktion (mprapi.h)

Die MprConfigServerGetInfo-Funktion ruft Konfigurationsinformationen auf Serverebene für den angegebenen Router ab.

Syntax

DWORD MprConfigServerGetInfo(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [out] LPBYTE *lplpbBuffer
);

Parameter

[in] hMprConfig

Verarbeiten Sie die Routerkonfiguration. Rufen Sie dieses Handle ab, indem Sie MprConfigServerConnect aufrufen.

[in] dwLevel

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

Wert Strukturformat
0 Windows 2000 Server oder höher: MPR_SERVER_0
1 Windows Server 2003 oder höher: MPR_SERVER_1
2 Windows Server 2008 oder höher: MPR_SERVER_2

[out] lplpbBuffer

Nach erfolgreichem Abschluss zeigt ein Zeiger auf eine MPR_SERVER_0, MPR_SERVER_1,
oder MPR_SERVER_2 Struktur. Der dwLevel-Parameter gibt den Typ der Struktur an. Geben Sie den Speicher für diesen Puffer mit MprConfigBufferFree frei.

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_INVALID_PARAMETER
Mindestens eine der folgenden Optionen muss zutreffen:
  • Der hMprConfig-Parameter ist NULL.
  • Der dwLevel-Parameter ist nicht 0.
  • Der lplpBuffer-Parameter ist NULL.
ERROR_NOT_ENOUGH_MEMORY
Unzureichende Ressourcen, um den Vorgang abzuschließen.
Andere
Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

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

FormatMessage

MPR_SERVER_0

MPR_SERVER_1

MPR_SERVER_2

MprConfigBufferFree

MprConfigServerConnect

MprConfigServerSetInfo

Routerkonfigurationsfunktionen

Referenz zur Routerverwaltung