Función MprAdminInterfaceGetCredentialsEx (mprapi.h)
Use la función MprAdminInterfaceGetCredentialsEx para recuperar información de credenciales extendidas para la interfaz especificada. Use esta función para recuperar la información de credenciales usada para protocolos de autenticación extensible (EAP).
Sintaxis
DWORD MprAdminInterfaceGetCredentialsEx(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwLevel,
[out] LPBYTE *lplpbBuffer
);
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 se devuelve la información en el parámetro lplpbBuffer . Los valores aceptables para dwLevel incluyen 0 o 1, como se muestra en la tabla siguiente.
| Valor | Formato de estructura |
|---|---|
| 0 | Windows 2000 Server: MPR_CREDENTIALSEX_0 |
| 1 | Windows Server 2003 o posterior: MPR_CREDENTIALSEX_1 |
Un valor de 1 indica que la información es una clave precompartida para la interfaz, que está en un formato cifrado.
[out] lplpbBuffer
Al finalizar correctamente, un puntero a una estructura de MPR_CREDENTIALSEX_0 o MPR_CREDENTIALSEX_1 . El parámetro dwLevel indica el tipo de estructura. Libere la memoria ocupada por esta estructura con MprAdminBufferFree.
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 |
|---|---|
|
La aplicación que realiza la llamada no tiene privilegios suficientes. |
|
El valor hInterface no es válido. |
|
El parámetro lplpbBuffer es NULL. |
|
Recursos insuficientes para completar la operación. |
|
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
MprAdminInterfaceGetCredentials