Compartir a través de

Función MprAdminInterfaceSetCredentials (mprapi.h)

  • Artículo

Use la función MprAdminInterfaceSetCredentials para establecer el dominio, el nombre de usuario y la contraseña que se usarán para marcar fuera en la interfaz de marcado a petición especificada.

Sintaxis

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

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.

[in] lpwsUserName

Puntero a una cadena Unicode terminada en null que especifica el nombre de usuario.

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

[in] lpwsDomainName

Puntero a una cadena Unicode terminada en null que especifica el nombre de dominio.

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

[in] lpwsPassword

Puntero a una cadena Unicode terminada en null que especifica la contraseña.

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

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_INVALID_PARAMETER
 Se cumple al menos una de las siguientes condiciones:
  • El parámetro lpwsInterfaceName es NULL o es mayor que MAX_INTERFACE_NAME_LEN.
  • Al menos uno de los parámetros lpwsUserName, lpwsPassword y lpwsDomainName es demasiado largo y, por tanto, no es válido. Vea la sección Comentarios para obtener más información.
ERROR_NOT_ENOUGH_MEMORY
 Memoria insuficiente para crear una nueva estructura de datos que contenga las credenciales.
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 llama especifica NULL para los tres parámetros, MprAdminInterfaceSetCredentials quita toda la información de credenciales de esta interfaz.

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 MprAdminInterfaceSetCredentials es diferente de MprAdminInterfaceGetCredentials.

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

MprAdminInterfaceGetCredentials

MprAdminInterfaceGetInfo

Funciones de administración del enrutador

Referencia de administración de enrutadores