Funzione MprAdminInterfaceCreate (mprapi.h)

Articolo
08/24/2023

La funzione MprAdminInterfaceCreate crea un'interfaccia in un server specificato.

Sintassi

DWORD MprAdminInterfaceCreate(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [in]  LPBYTE            lpbBuffer,
  [out] HANDLE            *phInterface
);

Parametri

[in] hMprServer

Gestire il router su cui eseguire questa chiamata. Ottenere questo handle chiamando MprAdminServerConnect.

[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 un MPR_INTERFACE_0, MPR_INTERFACE_1,
MPR_INTERFACE_2 o struttura di MPR_INTERFACE_3 . Il parametro dwLevel indica il tipo di struttura.

[out] phInterface

Puntatore a una variabile HANDLE . La variabile riceve un handle da usare in tutte le chiamate successive per gestire questa interfaccia.

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_DDM_NOT_RUNNING	Il tipo di interfaccia router non è supportato perché Dynamic Interface Manager è configurato per l'esecuzione solo in una LAN.
ERROR_INTERFACE_ALREADY_EXISTS	Esiste già un'interfaccia con lo stesso nome.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
ERROR_NOT_SUPPORTED	Il valore dwLevel non è valido.

Commenti

La funzione MprAdminInterfaceCreate supporta la struttura MPR_INTERFACE_2 . Tuttavia, MprConfigInterfaceCreate non. Per creare un'interfaccia di composizione 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