Funzione MprConfigInterfaceGetInfo (mprapi.h)

Articolo
08/24/2023

La funzione MprConfigInterfaceGetInfo recupera la configurazione per l'interfaccia specificata dal router.

Sintassi

DWORD MprConfigInterfaceGetInfo(
  [in]      HANDLE  hMprConfig,
  [in]      HANDLE  hRouterInterface,
  [in]      DWORD   dwLevel,
  [in, out] LPBYTE  *lplpBuffer,
  [out]     LPDWORD lpdwBufferSize
);

Parametri

[in] hMprConfig

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

[in] hRouterInterface

Gestire la configurazione dell'interfaccia per cui recuperare le informazioni. Ottenere questo handle chiamando MprConfigInterfaceCreate, MprConfigInterfaceGetHandle o MprConfigInterfaceEnum.

[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, 2 e 3, come indicato nella tabella seguente.

Valore	Formato struttura
0	MPR_INTERFACE_0
1	MPR_INTERFACE_1
2	MPR_INTERFACE_2
3	Windows Server 2008 o versione successiva: MPR_INTERFACE_3

[in, out] lplpBuffer

In input, un puntatore non NULL .

Al termine, un puntatore a una matrice di MPR_INTERFACE_0 , MPR_INTERFACE_1,
MPR_INTERFACE_2 o struttura di MPR_INTERFACE_3 . Il parametro dwLevel indica il tipo di struttura. Liberare questo buffer chiamando MprConfigBufferFree.

[out] lpdwBufferSize

Puntatore a una variabile DWORD . Questa variabile riceve le dimensioni, in byte, dei dati restituiti tramite lplpBuffer.

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: hMprConfig è NULL hRouterInterface è NULL dwLevel non è 0, 1, 2 o 3. lplpBuffer è NULL lpdwBufferSize è NULL
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
ERROR_NO_SUCH_INTERFACE	L'interfaccia che corrisponde a hRouterInterface non è presente nella configurazione del router.

Requisiti


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