Función MprAdminInterfaceSetInfo (mprapi.h)

Artículo
03/15/2023

La función MprAdminInterfaceSetInfo establece información para una interfaz especificada en un servidor especificado.

Sintaxis

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

Parámetros

[in] hMprServer

Identificador del enrutador que se va a consultar. Este identificador se obtiene de una llamada anterior a MprAdminServerConnect.

[in] hInterface

Identificador de la interfaz obtenida por una llamada anterior a MprAdminInterfaceCreate.

[in] dwLevel

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

Valor	Formato de estructura
0	MPR_INTERFACE_0
1	MPR_INTERFACE_1
2	MPR_INTERFACE_2
3	Windows Server 2008 o posterior: MPR_INTERFACE_3

[in] lpbBuffer

Puntero a un MPR_INTERFACE_0, MPR_INTERFACE_1,
MPR_INTERFACE_2 o estructura de MPR_INTERFACE_3 . El parámetro dwLevel indica el tipo de estructura.

Valor devuelto

Si la función se realiza 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 lplpbBuffer es NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para completar la operación.
ERROR_NOT_SUPPORTED	El valor dwLevel no es válido.

Comentarios

La función MprAdminInterfaceSetInfo admite la estructura MPR_INTERFACE_2 . Sin embargo, MprConfigInterfaceSetInfo no. Para realizar cambios persistentes en una interfaz de marcado a petición, llame a MprAdminInterfaceSetInfo con MPR_INTERFACE_2 y, a continuación, llame a MprConfigInterfaceSetInfo con MPR_INTERFACE_0 o MPR_INTERFACE_1.

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