Función MprAdminInterfaceSetCredentialsEx (mprapi.h)

Artículo
02/29/2024

Use la función MprAdminInterfaceSetCredentialsEx para establecer información de credenciales extendidas para una interfaz. Use esta función para establecer la información de credenciales usada para protocolos de autenticación extensible (EAP).

Sintaxis

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

Parámetros

[in] hMprServer

Maneje a un enrutador. Este identificador se obtiene de una llamada anterior a MprAdminServerConnect.

[in] hInterface

Identificador de la interfaz. Este identificador se obtiene de 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 o 1, como se muestra en la tabla siguiente. Un valor de 1 indica que la información es una clave precompartida para la interfaz.

Valor	Formato de estructura
0	Windows 2000 Server: MPR_CREDENTIALSEX_0
1	Windows Server 2003 o posterior: MPR_CREDENTIALSEX_1

[in] lpbBuffer

Puntero a una estructura de MPR_CREDENTIALSEX_0 o MPR_CREDENTIALSEX_1 . 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

Para eliminar una clave precompartida, llame a MprAdminInterfaceSetCredentials con el miembro dwSize de la estructura de MPR_CREDENTIALSEX_1 establecida en cero.

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