MprAdminServerSetCredentials 函数 (mprapi.h)

MprAdminServerSetCredentials 函数设置指定服务器的预共享密钥。

语法

DWORD MprAdminServerSetCredentials(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

[in] hMprServer

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

[in] dwLevel

一个 DWORD 值，用于描述 在 lpbBuffer 参数中构建信息的格式。必须为零。

[in] lpbBuffer

指向包含服务器的预共享密钥的MPR_CREDENTIALSEX_1 结构的指针。

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

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

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

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

若要删除预共享密钥，请在将 MPR_CREDENTIALSEX_1dwSize 成员设置为零的情况下调用 MprAdminServerSetCredentials。