Compartir a través de


Función MprAdminInterfaceGetCredentials (mprapi.h)

Use la función MprAdminInterfaceGetCredentials para recuperar el dominio, el nombre de usuario y la contraseña para marcar fuera en la interfaz de marcado a petición especificada.

Sintaxis

DWORD MprAdminInterfaceGetCredentials(
  [in]  LPWSTR lpwsServer,
  [in]  LPWSTR lpwsInterfaceName,
  [out] LPWSTR lpwsUserName,
  [out] LPWSTR lpwsPassword,
  [out] LPWSTR lpwsDomainName
);

Parámetros

[in] lpwsServer

Puntero a una cadena Unicode terminada en null que especifica el nombre del enrutador en el que se va a ejecutar esta llamada.

Este parámetro es opcional. Si la aplicación que realiza la llamada especifica NULL para este parámetro, la llamada se ejecuta en el equipo local.

[in] lpwsInterfaceName

Puntero a una cadena Unicode terminada en null que especifica el nombre de la interfaz de marcado a petición. Use MprAdminInterfaceGetInfo para obtener el nombre de la interfaz.

[out] lpwsUserName

Puntero a una cadena Unicode que recibe el nombre del usuario. Esta cadena debe ser UNLEN+1 long.

Este parámetro es opcional. Si la aplicación que realiza la llamada especifica NULL para este parámetro, la función no devuelve el nombre de usuario.

[out] lpwsPassword

Puntero a una cadena Unicode que recibe la contraseña. Esta cadena debe ser PWLEN+1 long.

Este parámetro es opcional. Si la aplicación que realiza la llamada especifica NULL para este parámetro, la función no devuelve la contraseña.

[out] lpwsDomainName

Puntero a una cadena Unicode que recibe el nombre de dominio. Esta cadena debe ser DNLEN+1 long.

Este parámetro es opcional. Si la aplicación que realiza la llamada especifica NULL para este parámetro, la función no devuelve el nombre de dominio.

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_CANNOT_FIND_PHONEBOOK_ENTRY
La interfaz especificada no tiene ningún parámetro de marcado a petición asociado.
ERROR_INVALID_PARAMETER
El parámetro lpwsInterfaceName es NULL.
NO_ERROR
Los parámetros lpwsUserName, lpwsPassword y lpwsDomainName son todos NULL.
Otros
Use FormatMessage para recuperar el mensaje de error del sistema que corresponde al código de error devuelto.

Comentarios

Los parámetros lpwsUserName, lpwsPassword y lpwsDomainName son opcionales. Si la aplicación que realiza la llamada especifica NULL para los tres parámetros, MprAdminInterfaceGetCredentials devuelve NO_ERROR y el dominio, el nombre de usuario y la contraseña no se devuelven.

Las constantes UNLEN, PWLEN y DNLEN son las longitudes máximas para el nombre de usuario, la contraseña y el nombre de dominio. Estas constantes se definen en lmcons.h.

Tenga en cuenta que el orden de los parámetros en MprAdminInterfaceGetCredentials es diferente de MprAdminInterfaceSetCredentials.

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

Consulte también

FormatMessage

MprAdminInterfaceSetCredentials

Funciones de administración del enrutador

Referencia de administración de enrutadores