IWCNDevice::GetStringAttribute メソッド (wcndevice.h)

IWCNDevice::GetStringAttribute メソッドは、キャッシュされた属性を文字列としてデバイスから取得します。

構文

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

パラメーター

[in] AttributeType

特定 の属性値 (WCN_PASSWORD_TYPE など) を表す WCN_ATTRIBUTE_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