Funzione MprConfigInterfaceCreate (mprapi.h)

Articolo
08/24/2023

La funzione MprConfigInterfaceCreate crea un'interfaccia router nella configurazione del router specificata.

Sintassi

DWORD MprConfigInterfaceCreate(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [in]  LPBYTE lpbBuffer,
  [out] HANDLE *phRouterInterface
);

Parametri

[in] hMprConfig

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

[in] dwLevel

Valore DWORD che descrive il formato in cui le informazioni sono strutturate nel parametro lpbBuffer . 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 un MPR_INTERFACE_0, MPR_INTERFACE_1,
MPR_INTERFACE_2 o MPR_INTERFACE_3 struttura. Il parametro dwLevel indica il tipo di struttura.

[out] phRouterInterface

Puntatore a una variabile handle. Questa variabile riceve un handle per 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 dwLevel non è 0, 1, 2 o 3. lpbBuffer è NULL phRouterInterface è 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.

Commenti

La funzione MprAdminInterfaceCreate supporta la struttura MPR_INTERFACE_2 . Tuttavia, MprConfigInterfaceCrea non. Per creare un'interfaccia di chiamata a richiesta persistente dopo un riavvio, chiamare MprAdminInterfaceCreate con MPR_INTERFACE_2, quindi chiamare MprConfigInterfaceCreate con MPR_INTERFACE_0 o MPR_INTERFACE_1.

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