MprAdminInterfaceSetCredentials 函数 (mprapi.h)

  • 项目

使用 MprAdminInterfaceSetCredentials 函数设置将用于在指定的请求拨号接口上拨出的域、用户名和密码。

语法

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

parameters

[in] lpwsServer

指向 以 null 结尾的 Unicode 字符串的指针，该字符串指定要对其执行此调用的路由器的名称。

此参数是可选的。 如果调用应用程序为此参数指定 NULL ，则在本地计算机上执行调用。

[in] lpwsInterfaceName

指向 以 null 结尾的 Unicode 字符串的指针，该字符串指定请求拨号接口的名称。 使用 MprAdminInterfaceGetInfo 获取接口名称。

[in] lpwsUserName

指向以 null 结尾的 Unicode 字符串的指针，该字符串指定用户名。

此参数是可选的。 如果调用应用程序为此参数指定 NULL ，则该函数不会更改与此接口关联的用户名。

[in] lpwsDomainName

指向以 null 结尾的 Unicode 字符串的指针，该字符串指定域名。

此参数是可选的。 如果调用应用程序为此参数指定 NULL ，则该函数不会更改与此接口关联的域名。

[in] lpwsPassword

指向指定密码的 以 null 结尾的 Unicode 字符串的指针。

此参数是可选的。 如果调用应用程序为此参数指定 NULL ，则该函数不会更改与此接口关联的密码。

返回值

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

值 含义
ERROR_INVALID_PARAMETER
 以下至少一个条件成立：
  • lpwsInterfaceName 参数为 NULL，或者其长度超过 MAX_INTERFACE_NAME_LEN。
  • 至少一个 lpwsUserName、 lpwsPassword 和 lpwsDomainName 参数太长，因此无效。 有关详细信息，请参阅备注部分。
ERROR_NOT_ENOUGH_MEMORY
 内存不足，无法创建新的数据结构以包含凭据。
其他
 使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。
 
 

注解

lpwsUserName、lpwsPassword 和 lpwsDomainName 参数是可选的。 如果调用应用程序为所有三个参数指定 NULL ， MprAdminInterfaceSetCredentials 将删除此接口的所有凭据信息。

常量 UNLEN、PWLEN 和 DNLEN 是用户名、密码和域名的最大长度。 这些常量在 Lmcons.h 中定义。

请注意， MprAdminInterfaceSetCredentials 中的参数顺序不同于 MprAdminInterfaceGetCredentials。

要求

   
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 mprapi.h
Library Mprapi.lib
DLL Mprapi.dll

另请参阅

FormatMessage

MprAdminInterfaceGetCredentials

MprAdminInterfaceGetInfo

路由器管理功能

路由器管理参考