シングル サインオン インターフェイスの動作を変更する方法

  • [アーティクル]

エンタープライズ シングル サインオン (SSO) オブジェクト モデルのオブジェクトの多くは、IPropertyBag インターフェイスを公開するので、指定したオブジェクトの動作を変更することができます。 SSO オブジェクトの QueryInterface を呼び出すと、IPropertyBag インターフェイスを取得し、それを使用して現在のオブジェクトの動作を変更できます。

指定した SSO インターフェイスの動作を変更するには

  1. 指定したインターフェイスの QueryInterface を使用して、IPropertyBag インスタンスを取得します。

  2. 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 情報を送信するサーバーを決定するための標準的な動作は次のとおりです。

    1. 現在のユーザーのレジストリを検索します。 コマンド ライン ツールまたは GUI を使用して、サーバー名が現在のユーザーに設定されます。

    2. すべてのユーザーのレジストリを検索します。 コマンド ライン ツールまたは GUI を使用して、サーバー名がすべてのユーザーに設定されます。

    3. 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 では、メソッドをポーリングして完了したかどうかを確認することもできます。