ISSOConfigStore::GetConfigInfo

  • 發行項

 

方法 GetConfigInfo 會從組態存放區取得組態資訊。

語法

  
HRESULT GetConfigInfo(  
BSTR bstrApplication,  
BSTR bstrIdentifier,  
LONG lFlags,  
IPropertyBag* ppbConfigInfo  
);  

  
GetConfigInfo(  
bstrApplication As BSTR,  
bstrIdentifier As BSTR,  
lFlags As LONG,  
ppbConfigInfo As IPropertyBag  
)

參數

bstrApplication
[in]包含 Single Sign-On (SSO) 伺服器的字串。 這是選用屬性。

bstrApplication
[in]包含 SSO 伺服器的字串。 這是選用屬性。

bstrIdentifier
[in]字串，其中包含組態資訊的識別碼。 這個字串通常會是 GUID 字串。

bstrIdentifier
[in]字串，其中包含組態資訊的識別碼。 這個字串通常會是 GUID 字串。

lFlags
[in]包含旗標的長整數。

lFlags
[in]包含旗標的長整數。

ppbConfigInfo
[in]空白屬性包的指標，該包會填入組態資訊作為名稱/值組。

ppbConfigInfo
[in]空白屬性包的指標，該包會填入組態資訊作為名稱/值組。

傳回值

這個方法不會傳回值。

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK 已成功從組態存放區傳回組態資訊。
E_ACCESSDENIED 拒絕存取。
E_INVALIDARG 無效引數。

備註

此方法可以在管理或執行階段 (查閱) 模式下執行。 如果需要執行階段 (查閱) 模式，呼叫者便會指定 SSO_FLAG_LOOKUP。 預設模式是管理模式。

在管理模式中，不會傳回遮罩的屬性。 而是會使屬性遺失。 未遮罩的屬性則會傳回。 管理模式可以指定任何 SSO 伺服器，而非僅限於本機電腦。

在執行階段模式中，包括遮罩屬性的所有屬性都會傳回。 因為執行時間模式只會使用目前電腦上的 SSO 伺服器，所以將會忽略 bstrSSOServer 參數。

如果 bstrSSOServer 參數為 Null，則會從登錄取得 SSO 伺服器位置。 (這僅適用于管理模式。執行時間模式一律使用本機 computer.) 如果登錄中沒有伺服器位置，則會使用本機電腦。

為了取得組態資訊，對此方法提供填入屬性的空屬性包。 這允許使用屬性包的 BizTalk Server 2006 實作，其可以根據BizTalk Server 2006 特定的格式慣例，處理從 BSTR 到實際變體類型的轉換。 屬性值會是 Host Integration Server 的 XML 標記。

範例程式碼

  
ConfigStore  
bstrApplication  
bstrIdentifier  
lFlags  
ppbConfigInfo

另請參閱

ISSOConfigStore 介面 (COM)
企業單一登入程式設計