ホーム › Security.Authentication.Identity.Provider › IConnectedIdentityProvider
IConnectedIdentityProvider
COM公式ドキュメント
接続された ID プロバイダーとやり取りするためのメソッドを提供します。
メソッド 5
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
ID をドメイン ユーザーに接続します。
| AuthBuffer | BYTE* | in | オンライン ID の資格情報を格納した、マーシャリングされた認証バッファー (SEC_WINNT_AUTH_IDENTITY_EX2 構造体) です。このバッファーは、呼び出し元が CredPackAuthenticationBuffer 関数を CRED_PACK_ID_PROVIDER_CREDENTIALS オプションと共に使用して構築するか、オンライン ID 資格情報プロバイダーが CredUIPromptForWindowsCredentials 関数から返したものを使用できます。バッファーは、SspiEncryptAuthIdentityEx 関数を SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON オプションと共に呼び出すことで、任意に暗号化できます。 |
| AuthBufferSize | DWORD | in | AuthBuffer パラメーターのサイズ (バイト単位)。 |
戻り値
メソッドが成功した場合は S_OK を返します。
メソッドが失敗した場合は Win32 エラー コードを返します。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 | |
| ユーザー名またはパスワードが正しくありません。 | |
| ドメイン ユーザーは、このプロバイダーのオンライン ID に既に接続または関連付けられています。 | |
| オンライン ユーザー名の形式が無効です。 |
解説(Remarks)
資格情報がセキュア デスクトップ上で収集された場合、AuthBuffer パラメーターはシステム コンテキストで暗号化されることがあります。その場合、ID プロバイダーは現在のプロセス内で資格情報を復号できません。バッファーを復号するには、ID プロバイダーは資格情報をシステム コンテキストで実行中のプロセスに送信する必要があります。
vtbl 4 HRESULT DisconnectIdentity()
オンライン ID を現在のドメイン ユーザーから切断します。
戻り値
メソッドが成功した場合、S_OK を返します。
メソッドが失敗した場合、Win32 エラー コードを返します。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 | |
| ドメイン ユーザーはオンライン ID に接続されていません。 |
| Connected | BOOL* | out | ID が現在接続済みかどうかを示す BOOL 値を受け取るポインタである。 |
vtbl 6 HRESULT GetUrl(IDENTITY_URL Identifier, IBindCtx* Context, VARIANT* PostData, LPWSTR* Url)
指定されたウィザードまたは Web ページの URL 文字列を返します。
| Identifier | IDENTITY_URL | in | 返すウィザードまたは Web ページを識別します。 |
| Context | IBindCtx* | inoptional | URL が表示されるコンテキストを記述します。 |
| PostData | VARIANT* | out | 指定した URL にポストされる、VT_ARRAY および VT_UI1 型の VARIANT です。ポスト データが不要な場合、このパラメーターには VT_EMPTY を設定します。 |
| Url | LPWSTR* | out | 指定された ID ウィザードまたは Web ページの URL を返します。URL は https:// で始まる必要があります。 |
戻り値
メソッドが成功した場合、S_OK を返します。
メソッドが失敗した場合、Win32 エラー コードを返します。
vtbl 7 HRESULT GetAccountState(ACCOUNT_STATE* pState)
| pState | ACCOUNT_STATE* | out | アカウントの現在の状態を表す ACCOUNT_STATE 値を受け取るポインタである。 |
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IConnectedIdentityProvider "{B7417B54-E08C-429B-96C8-678D1369ECB1}" #usecom global IConnectedIdentityProvider IID_IConnectedIdentityProvider "{}" #comfunc global IConnectedIdentityProvider_ConnectIdentity 3 var,int #comfunc global IConnectedIdentityProvider_DisconnectIdentity 4 #comfunc global IConnectedIdentityProvider_IsConnected 5 var #comfunc global IConnectedIdentityProvider_GetUrl 6 int,sptr,var,var #comfunc global IConnectedIdentityProvider_GetAccountState 7 var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IConnectedIdentityProvider "{B7417B54-E08C-429B-96C8-678D1369ECB1}" #usecom global IConnectedIdentityProvider IID_IConnectedIdentityProvider "{}" #comfunc global IConnectedIdentityProvider_ConnectIdentity 3 sptr,int #comfunc global IConnectedIdentityProvider_DisconnectIdentity 4 #comfunc global IConnectedIdentityProvider_IsConnected 5 sptr #comfunc global IConnectedIdentityProvider_GetUrl 6 int,sptr,sptr,sptr #comfunc global IConnectedIdentityProvider_GetAccountState 7 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。