通过

MprAdminInterfaceGetCredentialsEx 函数 (mprapi.h)

  • 项目

使用 MprAdminInterfaceGetCredentialsEx 函数检索指定接口的扩展凭据信息。 使用此函数可检索用于可扩展身份验证协议的凭据信息， (EAP) 。

语法

DWORD MprAdminInterfaceGetCredentialsEx(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

参数

[in] hMprServer

路由器的句柄。 此句柄是从上一次调用 MprAdminServerConnect 获取的。

[in] hInterface

接口的句柄。 此句柄是从上一次调用 MprAdminInterfaceCreate 获取的。

[in] dwLevel

一个 DWORD 值，该值描述 在 lplpbBuffer 参数中返回信息的格式。 dwLevel 的可接受值包括 0 或 1，如下表所示。

值 结构格式
0 Windows 2000 Server： MPR_CREDENTIALSEX_0
1 Windows Server 2003 或更高版本： MPR_CREDENTIALSEX_1
 

值为 1 表示信息是接口的预共享密钥，该密钥采用加密格式。

[out] lplpbBuffer

成功完成后，指向 MPR_CREDENTIALSEX_0 或 MPR_CREDENTIALSEX_1 结构的指针。 dwLevel 参数指示结构的类型。 使用 MprAdminBufferFree 释放此结构占用的内存。

返回值

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

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

值 含义
ERROR_ACCESS_DENIED
 调用应用程序没有足够的权限。
ERROR_INVALID_HANDLE
 hInterface 值无效。
ERROR_INVALID_PARAMETER
 lplpbBuffer 参数为 NULL。
ERROR_NOT_ENOUGH_MEMORY
 资源不足，无法完成操作。
ERROR_NOT_SUPPORTED
 dwLevel 值无效。

要求

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

另请参阅

MPR_CREDENTIALSEX_0

MPR_CREDENTIALSEX_1

MprAdminInterfaceCreate

MprAdminInterfaceGetCredentials

MprAdminInterfaceSetCredentialsEx

MprAdminServerConnect