Funzione MprConfigInterfaceCreate (mprapi.h)
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 |
|---|---|
|
Almeno uno dei seguenti è vero:
|
|
Risorse insufficienti per completare l'operazione. |
|
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 |