Enterprise Single Sign-On (SSO) オブジェクト モデルのオブジェクトの多くは IPropertyBag インターフェイスを公開しているため、指定したオブジェクトの動作を変更できます。 SSO オブジェクトで QueryInterface を呼び出す場合は、IPropertyBag インターフェイスを取得し、それを使用して現在のオブジェクトの動作を変更できます。
指定した SSO インターフェイスの動作を変更するには
指定したインターフェイスで QueryInterface を使用して、IPropertyBag インスタンスを取得します。
IPropertyBag.Write を使用して、インターフェイスのプロパティ、型、および値を設定します。
次の表では、IPropertyBag propName パラメーターと ptrVar パラメーターの有効な値について説明します。
propName | タイプ | ptrValue | 使用可能なプラットフォーム |
---|---|---|---|
CurrentSSOServer(現在のSSOサーバー) | VT_BSTR | 情報を送信するサーバーの名前 | 全て |
トランザクション | VT_UNKNOWN VT_EMPTY |
スコープをクリアするためには、DTC ITransaction ポインターまたは NULL を指定します。 | ISSOConfigStore::SetConfigInfo ISSOConfigStore::GetConfigInfo ISSOConfigStore::DeleteConfigInfo ISSOAdmin::CreateApplication ISSOAdmin::DeleteApplication ISSOAdmin::UpdateApplication ISSOAdmin::CreateFieldInfo ISSOMapper::GetFieldInfo |
AppFilterFlags | VT_I4 VT_UI4 |
フィルター処理するアプリケーションを制御するフラグ。 | ISSOMapper::GetApplications ISSOMapper2::GetApplications2 |
アプリフィルタフラグマスク | 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 を次の 1 つ以上に設定することです。
SSOアプリタイプ(個別)
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 を使用すると、メソッドをポーリングして完了することもできます。