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。
如果函数失败，则返回值为以下错误代码之一。
| 值 | 含义 |
|---|---|
|
以下至少一个条件成立：
|
|
内存不足，无法创建新的数据结构以包含凭据。 |
|
使用 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 |