シングル サインオン インターフェイスの動作を変更する方法
エンタープライズ シングル サインオン (SSO) オブジェクト モデルのオブジェクトの多くは、IPropertyBag インターフェイスを公開するので、指定したオブジェクトの動作を変更することができます。 SSO オブジェクトの QueryInterface を呼び出すと、IPropertyBag インターフェイスを取得し、それを使用して現在のオブジェクトの動作を変更できます。
指定した SSO インターフェイスの動作を変更するには
指定したインターフェイスの QueryInterface を使用して、IPropertyBag インスタンスを取得します。
IPropertyBag.Write を使用して、インターフェイスのプロパティ、種類、および値を設定します。
次の表に、IPropertyBag の propName パラメーターと ptrVar パラメーターの有効な値を示します。
propName | Type | ptrValue | 以下で使用可能 |
---|---|---|---|
CurrentSSOServer | VT_BSTR | 情報の送信先のサーバーの名前 | すべて |
トランザクション | VT_UNKNOWN VT_EMPTY |
DTC ITransaction ポインター、またはスコープをクリアする NULL | ISSOConfigStore::SetConfigInfo ISSOConfigStore::GetConfigInfo ISSOConfigStore::DeleteConfigInfo ISSOAdmin::CreateApplication ISSOAdmin::D eleteApplication ISSOAdmin::UpdateApplication ISSOAdmin::CreateFieldInfo ISSOMapper::GetFieldInfo |
AppFilterFlags | VT_I4 VT_UI4 |
どのアプリケーションをフィルター処理するかを制御するフラグ | ISSOMapper::GetApplications ISSOMapper2::GetApplications2 |
AppFilterFlagsMask | VT_I4 VT_UI4 |
どのアプリケーションをフィルター処理するかを制御するフラグ マスク | ISSOMapper::GetApplications ISSOMapper2::GetApplications2 |
AsyncCall | VT_BOOL | 非同期 RPC を使用して呼び出す場合は true、同期 RPC を使用する場合は false | ISSOConfigOM::GetServerStatus ISSOAdmin::GetGlobalInfo |
CurrentSSOServer: SSO 情報を送信するサーバーを決定するための標準的な動作は次のとおりです。
現在のユーザーのレジストリを検索します。 コマンド ライン ツールまたは GUI を使用して、サーバー名が現在のユーザーに設定されます。
すべてのユーザーのレジストリを検索します。 コマンド ライン ツールまたは GUI を使用して、サーバー名がすべてのユーザーに設定されます。
SSO サーバー名がレジストリで見つからなかった場合は、現在のコンピューターを使用します。
指定したサーバーへの CurrentSSOServer の設定は、指定したインターフェイスの上記の処理をオーバーライドします。 CurrentSSOServer を設定すると、インターフェイスでの後続のメソッド呼び出しは、すべて指定したサーバーへ送信されます。
トランザクション: SSO オブジェクト モデルによって実行される操作のスコープを設定する DTC トランザクションを指定します。 現在のトランザクション スコープをクリアするには、DTC ITransaction ポインターを に
ptrValue
渡すか、"null" を渡す必要があります。AppFilterFlags/AppFilterMask: ISSOMapper.GetApplications および ISSOMapper2.GetApplications から返されるアプリケーションの種類を制御します。 アプリケーション フラグがフィルター フラグおよびフィルター フラグ マスクで指定されているフラグと一致すると、そのフラグが返されます。 アプリケーションのフィルター処理を実行する 1 つの方法は、AppFilterFlagsMask を SSO_FLAG_APP_FILTER_BY_TYPE に設定して、AppFilterFlags を次のフラグのいずれか (複数可) に設定することです。
SSO_APP_TYPE_INDIVIDUAL
SSO_APP_TYPE_GROUP
SSO_APP_TYPE_CONFIG_STORE
SSO_APP_TYPE_HOST_GROUP
SSO_APP_TYPE_PS_ADAPTER
SSO_APP_TYPE_PS_GROUP_ADAPTER
AsyncCall: true の場合、SSO は非同期リモート プロシージャ コール (RPC) を使用してメソッドを実行します。 実行中、メソッドは E_PENDING を返します。 その他の戻り値は、メソッドが完了したことを示します。 AsyncCall では、メソッドをポーリングして完了したかどうかを確認することもできます。