IWCNDevice::GetAttribute 方法 (wcndevice.h)

IWCNDevice::GetAttribute 方法从设备获取缓存的属性。

语法

HRESULT GetAttribute(
  [in]  WCN_ATTRIBUTE_TYPE AttributeType,
  [in]  DWORD              dwMaxBufferSize,
  [out] BYTE []            pbBuffer,
  [out] DWORD              *pdwBufferUsed
);

参数

[in] AttributeType

表示特定属性值 (WCN_ATTRIBUTE_TYPE 值,例如 ,WCN_PASSWORD_TYPE) 。

[in] dwMaxBufferSize

pbBuffer 的已分配大小(以字节为单位)。

[out] pbBuffer

用户分配的缓冲区,成功返回时,该缓冲区包含属性的内容。

[out] pdwBufferUsed

返回时,包含属性的大小(以字节为单位)。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
已成功检索属性。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
指定的属性不可用。
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
pbBuffer 指定的缓冲区不够大,无法包含返回的属性值。

注解

若要仅查询属性的大小,可以通过 dwMaxBufferSize 传递值 0 (零) ,并将相应地填充 pdwBufferUsed

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 wcndevice.h

另请参阅

IWCNDevice

WCN_ATTRIBUTE_TYPE