Compartir a través de


Función MprAdminInterfaceDeviceSetInfo (mprapi.h)

MprAdminInterfaceDeviceSetInfo crea o modifica un dispositivo que se usa en una interfaz de marcado a petición del enrutador.

Sintaxis

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

Parámetros

[in] hMprServer

Controle al enrutador en el que se va a ejecutar esta llamada. Obtenga este identificador llamando a MprAdminServerConnect.

[in] hInterface

Identificador de la interfaz. Obtenga este identificador de una llamada anterior a MprAdminInterfaceCreate o llamando a MprAdminInterfaceEnum.

[in] dwIndex

Especifica el índice basado en uno del dispositivo. Una interfaz de marcado a petición multi linked usa varios dispositivos.

[in] dwLevel

Valor DWORD que describe el formato en el que la información está estructurada en el parámetro lplpBuffer . Los valores aceptables para dwLevel incluyen 0 o 1, como se muestra en la tabla siguiente.

Valor Formato de estructura
0 MPR_DEVICE_0
1 MPR_DEVICE_1

[in] lpbBuffer

Puntero a una estructura de MPR_DEVICE_0 o MPR_DEVICE_1 . El parámetro dwLevel indica el tipo de estructura.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Valor Significado
ERROR_ACCESS_DENIED
La aplicación que realiza la llamada no tiene privilegios suficientes.
ERROR_INVALID_HANDLE
El valor hInterface no es válido.
ERROR_INVALID_PARAMETER
El parámetro lplpBuffer es NULL.
ERROR_NOT_ENOUGH_MEMORY
Recursos insuficientes para completar la operación.
ERROR_NOT_SUPPORTED
El valor dwLevel no es válido.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mprapi.h
Library Mprapi.lib
Archivo DLL Mprapi.dll

Consulte también

MPR_DEVICE_0

MPR_DEVICE_1

MprAdminInterfaceCreate

MprAdminInterfaceDeviceGetInfo