Win32 API 日本語リファレンス
ホームNetworkManagement.WindowsConnectNow › IWCNDevice

IWCNDevice

COM
IIDc100be9c-d33a-4a4b-bf23-bbef4663d017継承元IUnknown自前メソッド開始 vtbl3

メソッド 11

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT SetPassword(WCN_PASSWORD_TYPE Type, DWORD dwPasswordLength, BYTE* pbPassword)
TypeWCN_PASSWORD_TYPEin設定するパスワードの種類を示す WCN_PASSWORD_TYPE 列挙値を指定する。
dwPasswordLengthDWORDinpbPassword が指すパスワードのバイト数を指定する。
pbPasswordBYTE*inデバイスのプロビジョニングに使用するパスワードデータが格納されたバッファへのポインタである。
vtbl 4 HRESULT Connect(IWCNConnectNotify* pNotify)
pNotifyIWCNConnectNotify*inoptional接続処理の完了や失敗を受け取る IWCNConnectNotify コールバックインターフェイスへのポインタである。
vtbl 5 HRESULT GetAttribute(WCN_ATTRIBUTE_TYPE AttributeType, DWORD dwMaxBufferSize, BYTE* pbBuffer, DWORD* pdwBufferUsed)
AttributeTypeWCN_ATTRIBUTE_TYPEin取得する属性を示す WCN_ATTRIBUTE_TYPE 列挙値を指定する。
dwMaxBufferSizeDWORDinpbBuffer が指すバッファの最大バイト数を指定する。
pbBufferBYTE*out属性値を受け取るバッファへのポインタである。
pdwBufferUsedDWORD*outバッファに実際に書き込まれたバイト数を受け取るポインタである。
vtbl 6 HRESULT GetIntegerAttribute(WCN_ATTRIBUTE_TYPE AttributeType, DWORD* puInteger)
AttributeTypeWCN_ATTRIBUTE_TYPEin取得する整数属性を示す WCN_ATTRIBUTE_TYPE 列挙値を指定する。
puIntegerDWORD*out属性の整数値を受け取るポインタである。
vtbl 7 HRESULT GetStringAttribute(WCN_ATTRIBUTE_TYPE AttributeType, DWORD cchMaxString, LPWSTR wszString)
AttributeTypeWCN_ATTRIBUTE_TYPEin取得する文字列属性を示す WCN_ATTRIBUTE_TYPE 列挙値を指定する。
cchMaxStringDWORDinwszString が指すバッファに格納できる最大文字数を指定する。
wszStringLPWSTRout属性の文字列値を受け取るバッファへのポインタである。
vtbl 8 HRESULT GetNetworkProfile(DWORD cchMaxStringLength, LPWSTR wszProfile)
cchMaxStringLengthDWORDinwszProfile が指すバッファに格納できる最大文字数を指定する。
wszProfileLPWSTRoutデバイスのネットワークプロファイル(XML)を受け取るバッファへのポインタである。
vtbl 9 HRESULT SetNetworkProfile(LPWSTR pszProfileXml)
pszProfileXmlLPWSTRinデバイスに設定するネットワークプロファイルを表す XML 文字列を指定する。
vtbl 10 HRESULT GetVendorExtension(WCN_VENDOR_EXTENSION_SPEC* pVendorExtSpec, DWORD dwMaxBufferSize, BYTE* pbBuffer, DWORD* pdwBufferUsed)
pVendorExtSpecWCN_VENDOR_EXTENSION_SPEC*in取得するベンダー拡張を指定する WCN_VENDOR_EXTENSION_SPEC 構造体へのポインタである。
dwMaxBufferSizeDWORDinpbBuffer が指すバッファの最大バイト数を指定する。
pbBufferBYTE*outベンダー拡張データを受け取るバッファへのポインタである。
pdwBufferUsedDWORD*outバッファに実際に書き込まれたバイト数を受け取るポインタである。
vtbl 11 HRESULT SetVendorExtension(WCN_VENDOR_EXTENSION_SPEC* pVendorExtSpec, DWORD cbBuffer, BYTE* pbBuffer)
pVendorExtSpecWCN_VENDOR_EXTENSION_SPEC*in設定するベンダー拡張を指定する WCN_VENDOR_EXTENSION_SPEC 構造体へのポインタである。
cbBufferDWORDinpbBuffer が指すデータのバイト数を指定する。
pbBufferBYTE*in設定するベンダー拡張データが格納されたバッファへのポインタである。
vtbl 12 HRESULT Unadvise()
vtbl 13 HRESULT SetNFCPasswordParams(WCN_PASSWORD_TYPE Type, DWORD dwOOBPasswordID, DWORD dwPasswordLength, BYTE* pbPassword, DWORD dwRemotePublicKeyHashLength, BYTE* pbRemotePublicKeyHash, DWORD dwDHKeyBlobLength, BYTE* pbDHKeyBlob)
TypeWCN_PASSWORD_TYPEin設定するパスワードの種類を示す WCN_PASSWORD_TYPE 列挙値を指定する。
dwOOBPasswordIDDWORDinNFC 経由で取得した帯域外(OOB)パスワードの識別子を指定する。
dwPasswordLengthDWORDinpbPassword が指すパスワードのバイト数を指定する。
pbPasswordBYTE*inoptionalデバイスパスワードデータが格納されたバッファへのポインタである。
dwRemotePublicKeyHashLengthDWORDinpbRemotePublicKeyHash が指すハッシュのバイト数を指定する。
pbRemotePublicKeyHashBYTE*inoptionalリモートデバイスの公開鍵ハッシュが格納されたバッファへのポインタである。
dwDHKeyBlobLengthDWORDinpbDHKeyBlob が指す鍵 BLOB のバイト数を指定する。
pbDHKeyBlobBYTE*inoptionalDiffie-Hellman 鍵 BLOB が格納されたバッファへのポインタである。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"

出力引数:
#define global IID_IWCNDevice "{C100BE9C-D33A-4A4B-BF23-BBEF4663D017}"
#usecom global IWCNDevice IID_IWCNDevice "{}"
#comfunc global IWCNDevice_SetPassword           3 int,int,var
#comfunc global IWCNDevice_Connect               4 sptr
#comfunc global IWCNDevice_GetAttribute          5 int,int,var,var
#comfunc global IWCNDevice_GetIntegerAttribute   6 int,var
#comfunc global IWCNDevice_GetStringAttribute    7 int,int,var
#comfunc global IWCNDevice_GetNetworkProfile     8 int,var
#comfunc global IWCNDevice_SetNetworkProfile     9 wstr
#comfunc global IWCNDevice_GetVendorExtension    10 var,int,var,var
#comfunc global IWCNDevice_SetVendorExtension    11 var,int,var
#comfunc global IWCNDevice_Unadvise              12
#comfunc global IWCNDevice_SetNFCPasswordParams  13 int,int,int,var,int,var,int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。