Funzione MprConfigServerGetInfo (mprapi.h)

Articolo
02/29/2024

La funzione MprConfigServerGetInfo recupera le informazioni di configurazione a livello di server per il router specificato.

Sintassi

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

Parametri

[in] hMprConfig

Gestire la configurazione del router. Ottenere questo handle chiamando MprConfigServerConnect.

[in] dwLevel

Valore DWORD che descrive il formato in cui vengono restituite le informazioni nel parametro lplpBuffer . I valori accettabili per dwLevel includono 0, 1 e 2 come indicato nella tabella seguente.

Valore	Formato struttura
0	Windows 2000 Server o versioni successive: MPR_SERVER_0
1	Windows Server 2003 o versione successiva: MPR_SERVER_1
2	Windows Server 2008 o versioni successive: MPR_SERVER_2

[out] lplpbBuffer

Al termine, un puntatore a un MPR_SERVER_0, MPR_SERVER_1,
o MPR_SERVER_2 struttura. Il parametro dwLevel indica il tipo di struttura. Liberare la memoria per questo buffer usando MprConfigBufferFree.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_INVALID_PARAMETER	Almeno una delle condizioni seguenti è vera: Il parametro hMprConfig è NULL. Il parametro dwLevel non è zero. Il parametro lplpBuffer è NULL.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
Altri	Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mprapi.h
Libreria	Mprapi.lib
DLL	Mprapi.dll