ホーム › Security.Cryptography.Certificates › IBinaryConverter
IBinaryConverter
COMIDispatch (デュアル)✅ IDispatch を実装(デュアルインターフェース)。HSP では
comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
Unicode エンコードされた文字列をバイト配列から作成する、バイト配列を Unicode エンコードされた文字列から作成する、および文字列に適用される Unicode エンコードの種類を変更するための汎用的なメソッドを含みます。
メソッド 3
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
vtbl 7 HRESULT StringToString(LPWSTR strEncodedIn, EncodingType EncodingIn, EncodingType Encoding, LPWSTR* pstrEncoded)
文字列に適用される Unicode エンコードの種類を変更します。
| strEncodedIn | LPWSTR | in | 変更対象の文字列を格納する BSTR 変数。 |
| EncodingIn | EncodingType | in | 入力文字列に適用されている Unicode エンコードを指定する EncodingType 列挙値。 |
| Encoding | EncodingType | in | 出力文字列に適用する Unicode エンコードの種類を指定する EncodingType 列挙値。既定値は XCN_CRYPT_STRING_BASE64 です。 |
| pstrEncoded | LPWSTR* | out | エンコードされた出力文字列を格納する BSTR 変数へのポインター。 |
戻り値
関数が成功した場合、S_OK を返します。
関数が失敗した場合、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。
vtbl 8 HRESULT VariantByteArrayToString(VARIANT* pvarByteArray, EncodingType Encoding, LPWSTR* pstrEncoded)
バイト配列から Unicode エンコードされた文字列を作成します。
| pvarByteArray | VARIANT* | in | エンコード対象のバイトからなる VARIANT 配列へのポインター。配列内の各バイトは符号なし整数である必要があります。すなわち、VARTYPE 列挙値は VT_ARRAY | VT_UI1 と等しくなければなりません。 |
| Encoding | EncodingType | in | 入力文字列に適用されている Unicode エンコードを指定する EncodingType 列挙値。既定値は XCN_CRYPT_STRING_BASE64 です。 |
| pstrEncoded | LPWSTR* | out | Unicode エンコードされた証明書を格納する BSTR 変数へのポインター。 |
戻り値
関数が成功した場合、S_OK を返します。
関数が失敗した場合、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。
vtbl 9 HRESULT StringToVariantByteArray(LPWSTR strEncoded, EncodingType Encoding, VARIANT* pvarByteArray)
Unicode エンコードされた文字列からバイト配列を作成します。
| strEncoded | LPWSTR | in | Unicode エンコードされた文字列を格納する BSTR 変数。 |
| Encoding | EncodingType | in | 入力文字列に適用されている Unicode エンコードを指定する EncodingType 列挙値。既定値は XCN_CRYPT_STRING_BASE64 です。 |
| pvarByteArray | VARIANT* | out | バイトからなる VARIANT 配列へのポインター。VARTYPE 列挙値は VT_ARRAY | VT_UI1 と等しくなります。 |
戻り値
関数が成功した場合、S_OK を返します。
関数が失敗した場合、エラーを示す HRESULT 値を返します。一般的なエラーコードの一覧については、Common HRESULT Values を参照してください。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IBinaryConverter "{728AB302-217D-11DA-B2A4-000E7BBB2B09}" #usecom global IBinaryConverter IID_IBinaryConverter "{}" #comfunc global IBinaryConverter_StringToString 7 wstr,int,int,var #comfunc global IBinaryConverter_VariantByteArrayToString 8 var,int,var #comfunc global IBinaryConverter_StringToVariantByteArray 9 wstr,int,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IBinaryConverter "{728AB302-217D-11DA-B2A4-000E7BBB2B09}" #usecom global IBinaryConverter IID_IBinaryConverter "{}" #comfunc global IBinaryConverter_StringToString 7 wstr,int,int,sptr #comfunc global IBinaryConverter_VariantByteArrayToString 8 sptr,int,sptr #comfunc global IBinaryConverter_StringToVariantByteArray 9 wstr,int,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。