MprAdminServerGetCredentials 函数 (mprapi.h)

MprAdminServerGetCredentials 函数检索指定服务器的预共享密钥。

语法

DWORD MprAdminServerGetCredentials(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

参数

[in] hMprServer

Windows 服务器的句柄。 通过调用 MprAdminMIBServerConnect 获取此句柄。

[in] dwLevel

一个 DWORD 值,该值描述 在 lplpbBuffer 参数中返回信息的格式。 必须为零。

[out] lplpbBuffer

成功完成后,指向包含服务器预共享密钥 的MPR_CREDENTIALSEX_1 结构的指针。 使用 MprAdminBufferFree 释放此结构占用的内存。

返回值

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

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

含义
ERROR_ACCESS_DENIED
调用应用程序没有足够的权限。
ERROR_INVALID_PARAMETER
lplpbBuffer 参数为 NULL
ERROR_NOT_SUPPORTED
dwLevel 参数不为零。
其他
使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。

注解

服务器为所有用户维护单个预共享密钥。

要求

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

另请参阅

MPR_CREDENTIALSEX_1

MprAdminServerSetCredentials

路由器管理功能

路由器管理参考