Funzione MprAdminInterfaceSetInfo (mprapi.h)

La funzione MprAdminInterfaceSetInfo imposta informazioni per un'interfaccia specificata in un server specificato.

Sintassi

DWORD MprAdminInterfaceSetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

Parametri

[in] hMprServer

Gestire il router per eseguire query. Questo handle viene ottenuto da una chiamata precedente a MprAdminServerConnect.

[in] hInterface

Gestire l'interfaccia ottenuta da una chiamata precedente a MprAdminInterfaceCreate.

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

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_ACCESS_DENIED
L'applicazione chiamante non dispone di privilegi sufficienti.
ERROR_INVALID_HANDLE
Il valore hInterface non è valido.
ERROR_INVALID_PARAMETER
Il parametro lplpbBuffer è NULL.
ERROR_NOT_ENOUGH_MEMORY
Risorse insufficienti per completare l'operazione.
ERROR_NOT_SUPPORTED
Il valore dwLevel non è valido.

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

Vedi anche

MPR_INTERFACE_0

MPR_INTERFACE_1

MPR_INTERFACE_2

MPR_INTERFACE_3

MprAdminBufferFree

MprAdminInterfaceCreate

MprAdminInterfaceGetInfo

MprAdminServerConnect

Funzioni di amministrazione del router

Informazioni di riferimento sulla gestione dei router