MprConfigServerGetInfo-Funktion (mprapi.h)

Artikel
08/24/2023

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