Funzione MprConfigInterfaceSetInfo (mprapi.h)

Articolo
03/05/2024

La funzione MprConfigInterfaceSetInfo imposta la configurazione per l'interfaccia specificata.

Sintassi

DWORD MprConfigInterfaceSetInfo(
  [in] HANDLE hMprConfig,
  [in] HANDLE hRouterInterface,
  [in] DWORD  dwLevel,
  [in] LPBYTE lpbBuffer
);

Parametri

[in] hMprConfig

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

[in] hRouterInterface

Gestire la configurazione dell'interfaccia da aggiornare. Ottenere questo handle chiamando MprConfigInterfaceCreate, MprConfigInterfaceGetHandle o MprConfigInterfaceEnum.

[in] dwLevel

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

Puntatore a
MPR_INTERFACE_0, MPR_INTERFACE_1,
MPR_INTERFACE_2 o MPR_INTERFACE_3 struttura. Il parametro dwLevel indica il tipo di struttura. Le informazioni contenute in questa struttura vengono usate per aggiornare la configurazione dell'interfaccia.

Valore restituito

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

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

Valore	Significato
ERROR_INVALID_PARAMETER	Almeno uno dei seguenti è vero: hMprConfig è NULL. hRouterInterface è NULL. dwLevel non è 0, 1, 2 o 3. lpBuffer è NULL. Restituisce anche questo codice di errore se l'interfaccia è di tipo ROUTER_IF_TYPE_DEDICATED o ROUTER_IF_TYPE_INTERNAL e l'interfaccia è abilitata.
ERROR_NO_SUCH_INTERFACE	L'interfaccia corrispondente a hRouterInterface non è presente nella configurazione del router.
Altri	Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito.

Commenti

La funzione MprAdminInterfaceSetInfo supporta la struttura MPR_INTERFACE_2 . Tuttavia, MprConfigInterfaceSetInfo non è. Per apportare modifiche persistenti a un'interfaccia di chiamata a richiesta, chiamare MprAdminInterfaceSetInfo con MPR_INTERFACE_2, quindi chiamare MprConfigInterfaceSetInfo con MPR_INTERFACE_0 o MPR_INTERFACE_1.

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