Funzione MprAdminInterfaceDeviceSetInfo (mprapi.h)

Articolo
08/24/2023

MprAdminInterfaceDeviceSetInfo crea o modifica un dispositivo usato in un'interfaccia di richiesta router.

Sintassi

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

Parametri

[in] hMprServer

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

[in] hInterface

Gestire l'interfaccia. Ottenere questo handle da una chiamata precedente a MprAdminInterfaceCreate oppure chiamando MprAdminInterfaceEnum.

[in] dwIndex

Specifica l'indice in base uno del dispositivo. Un'interfaccia di chiamata a richiesta multi-collegata usa più dispositivi.

[in] dwLevel

Valore DWORD che descrive il formato in cui le informazioni sono strutturate nel parametro lplpBuffer . I valori accettabili per dwLevel includono 0 o 1 come indicato nella tabella seguente.

Valore	Formato struttura
0	MPR_DEVICE_0
1	MPR_DEVICE_1

[in] lpbBuffer

Puntatore a una struttura MPR_DEVICE_0 o MPR_DEVICE_1 . 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 lplpBuffer è NULL.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.
ERROR_NOT_SUPPORTED	Il valore dwLevel non è valido.

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_DEVICE_0

MPR_DEVICE_1

MprAdminInterfaceCreate

MprAdminInterfaceDeviceGetInfo

Condividi tramite