Función MprAdminInterfaceCreate (mprapi.h)

Artículo
08/24/2023

La función MprAdminInterfaceCreate crea una interfaz en un servidor especificado.

Sintaxis

DWORD MprAdminInterfaceCreate(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [in]  LPBYTE            lpbBuffer,
  [out] HANDLE            *phInterface
);

Parámetros

[in] hMprServer

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

[in] dwLevel

Valor DWORD que describe el formato en el que la información está estructurada en el parámetro lpBuffer . 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.

[out] phInterface

Puntero a una variable HANDLE . La variable recibe un identificador que se usará en todas las llamadas posteriores para administrar esta interfaz.

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_DDM_NOT_RUNNING	No se admite el tipo de interfaz de enrutador porque el Administrador de interfaz dinámica está configurado para ejecutarse solo en una LAN.
ERROR_INTERFACE_ALREADY_EXISTS	Ya existe una interfaz con el mismo nombre.
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 MprAdminInterfaceCreate admite la estructura MPR_INTERFACE_2 . Sin embargo, MprConfigInterfaceCreate no. Para crear una interfaz de marcado a petición que sea persistente después de un reinicio, llame a MprAdminInterfaceCreate con MPR_INTERFACE_2 y, a continuación, llame a MprConfigInterfaceCreate con MPR_INTERFACE_0 o MPR_INTERFACE_1.

Requisitos


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