Funzione MprConfigInterfaceGetInfo (mprapi.h)
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 |
---|---|
|
Almeno una delle condizioni seguenti è vera:
|
|
Risorse insufficienti per completare l'operazione. |
|
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 |