IWCNDevice::GetStringAttribute 方法 (wcndevice.h)

IWCNDevice::GetStringAttribute 方法以字符串的形式从设备获取缓存属性。

语法

HRESULT GetStringAttribute(
  [in]  WCN_ATTRIBUTE_TYPE AttributeType,
  [in]  DWORD              cchMaxString,
  [out] WCHAR []           wszString
);

参数

[in] AttributeType

表示特定属性值 (WCN_ATTRIBUTE_TYPE 值,例如 ,WCN_PASSWORD_TYPE) 。 例如,如果 属性不是本机 (字符串数据类型, WCN_TYPE_VERSION 本身是一个整数, 而WNC_TYPE_SSID 本身是 blob) ,则此函数将失败 并HRESULT_FROM_WIN32 (ERROR_INVALID_DATATYPE)

[in] cchMaxString

缓冲区 wszString 的大小(以字符为单位)。

[out] wszString

用户分配的缓冲区,成功返回时,该缓冲区包含以 NULL 结尾的供应商扩展字符串值。

返回值

...

返回代码 说明
S_OK
已成功检索属性。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
指定的属性不可用。
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
wszString 指定的缓冲区不够大,无法包含返回的属性值。
HRESULT_FROM_WIN32 (ERROR_INVALID_DATATYPE)
此属性不能表示为字符串。 例如,如果它是整数。

要求

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

另请参阅

IWCNDevice

WCN_ATTRIBUTE_TYPE