Funzione MprAdminInterfaceGetInfo (mprapi.h)

Articolo
02/29/2024

La funzione MprAdminInterfaceGetInfo recupera informazioni per un'interfaccia specificata in un server specificato.

Sintassi

DWORD MprAdminInterfaceGetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwLevel,
  [in] LPBYTE            *lplpbBuffer
);

Parametri

[in] hMprServer

Gestire il router su cui eseguire una query. Questo handle viene ottenuto da una chiamata precedente a MprAdminServerConnect.

[in] hInterface

Handle per l'interfaccia ottenuta da una chiamata precedente a MprAdminInterfaceCreate.

[in] dwLevel

Valore DWORD che descrive il formato in cui le informazioni sono strutturate nel parametro lplpbBuffer . 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

I valori 1, 2 e 3 sono validi solo per le interfacce di tipo ROUTER_CONNECTION_STATE.

[in] lplpbBuffer

Puntatore a un MPR_INTERFACE_0, MPR_INTERFACE_1,
MPR_INTERFACE_2 o struttura di MPR_INTERFACE_3 . Il parametro dwLevel indica il tipo di struttura. Liberare questa memoria chiamando MprAdminBufferFree.

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_ACCESS_DENIED	L'applicazione chiamante non dispone di privilegi sufficienti.
ERROR_INVALID_LEVEL	DwLevel è 2, ma tale livello non è supportato per l'interfaccia. Ad esempio, il tipo di interfaccia, come definito nella struttura MPR_INTERFACE_X, non è IF_TYPE_FULL_ROUTER.
ERROR_INVALID_HANDLE	Il valore hInterface non è valido.
ERROR_INVALID_PARAMETER	Il parametro lplpbBuffer è NULL.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
ERROR_NOT_SUPPORTED	Il valore dwLevel non è valido.

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