Funzione MprConfigInterfaceGetHandle (mprapi.h)

La funzione MprConfigInterfaceGetHandle recupera un handle alla configurazione dell'interfaccia specificata nella configurazione del router specificata.

Sintassi

DWORD MprConfigInterfaceGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  LPWSTR lpwsInterfaceName,
  [out] HANDLE *phRouterInterface
);

Parametri

[in] hMprConfig

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

[in] lpwsInterfaceName

Puntatore a una stringa Unicode con terminazione Null che specifica il nome dell'interfaccia per cui viene richiesto l'handle di configurazione. Usare il GUID dell'interfaccia come nome di un'interfaccia LAN.

[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 viene NO_ERROR.

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

Valore	Significato
ERROR_INVALID_PARAMETER	Il parametro hMprConfig è NULL oppure il parametro lpwsInterfaceName è NULL oppure entrambi i parametri sono NULL.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
ERROR_NO_SUCH_INTERFACE	L'interfaccia specificata non è stata trovata nella configurazione del router.
Altri	Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito.

 

 

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

Vedi anche

FormatMessage

MprConfigServerConnect

Funzioni di configurazione del router

Informazioni di riferimento sulla gestione dei router