ISSOAdmin.UpdateApplication 方法

UpdateApplication方法會更新 Enterprise 單一 Sign-On (SSO) server 資料庫中的應用程式資訊。

語法

  
HRESULT UpdateApplication(  
BSTR bstrApplicationName,  
BSTR bstrDescription,  
BSTR bstrContactInfo,  
BSTR bstrUserGroupName,  
BSTR bstrAdminGroupName,  
LONG lFlags,  
LONG lFlagMask  
);  
  
Function UpdateApplication(  
bstrApplicationName As String,  
bstrDescription As String,  
bstrContactInfo As String,  
bstrUserGroupName As String,  
bstrAdminGroupName As String,  
lFlags As Long  
)  

參數

bstrApplicationName
[in] 指定應用程式名稱的字串。 這個參數不可以是 NULL 或空字串,或是包含空格。 應用程式名稱不區分大小寫,但是將會保留原來的大小寫。 例如,ABC、abc 和 AbC 都會被視為相同的應用程式。

bstrApplicationName
[in] 指定應用程式名稱的字串。 這個參數不可以是 NULL 或空字串,或是包含空格。 應用程式名稱不區分大小寫,但是將會保留原來的大小寫。 例如,ABC、abc 和 AbC 都會被視為相同的應用程式。

bstrDescription
在指定應用程式描述的字串。

bstrDescription
在指定應用程式描述的字串。

bstrContactInfo
在字串,指定此應用程式的連絡人資訊。

bstrContactInfo
在字串,指定此應用程式的連絡人資訊。

bstrUserGroupName
在指定應用程式使用者組名的字串。 這個參數必須是有效的全域群組。

bstrUserGroupName
在指定應用程式使用者組名的字串。 這個參數必須是有效的全域群組。

bstrAdminGroupName
在指定應用程式系統管理員組名的字串。 這個參數必須是有效的全域群組。 如果以應用程式系統管理員身分執行,便會忽略這個參數。

bstrAdminGroupName
在指定應用程式系統管理員組名的字串。 這個參數必須是有效的全域群組。 如果以應用程式系統管理員身分執行,便會忽略這個參數。

lFlags
在指定是否啟用應用程式的整數。 若要啟用應用程式,請設定 SSO_FLAG_ENABLED 旗標。

lFlags
在指定是否啟用應用程式的整數。 若要啟用應用程式,請設定 SSO_FLAG_ENABLED 旗標。

lFlagMask
在若要變更旗標值,請將此遮罩設定為您需要變更的旗標。 例如,要啟用或停用「企業單一登入」,請將這個旗標設定為 SSO_FLAG_ENABLED。 FlagMask參數會指出您要變更的旗標,而 flags 參數表示該旗的新值。

lFlagMask
在若要變更旗標值,請將此遮罩設定為您需要變更的旗標。 例如,要啟用或停用「企業單一登入」,請將這個旗標設定為 SSO_FLAG_ENABLED。 FlagMask參數會指出您要變更的旗標,而 flags 參數表示該旗的新值。

傳回值

這個方法會傳回 HRESULT,指出它是否已成功完成。 如需詳細資訊,請參閱「錯誤值」一節。

不適用。

錯誤值

這個方法會傳回 HRESULT,其中包含下表的一個值。

這個方法會將全域 Err 物件的 Number 屬性設定為下表中的其中一個值,藉以表示錯誤。

描述
S_OK 此方法已成功。
E_ACCESSDENIED 拒絕呼叫者的存取。
E_INVALIDARG 偵測到無效的參數。

備註

若要存取此方法,您必須是 SSO 系統管理員、SSO 分支機構系統管理員,或是應用程式系統管理員。

規格需求

平臺: Windows 7、Windows Server 2008 R2、Windows Server 2008 SP2、Windows Vista SP2、Windows Server 2003 R2 SP2

另請參閱

企業單一登入程式設計
ISSOAdmin 介面 (COM)
ISSOAdmin 成員