ISSOAdmin.UpdateApplication 方法
UpdateApplication方法會更新 Enterprise Single Sign-On (SSO) 伺服器資料庫中的應用程式資訊。
語法
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
[in]指定應用程式描述的字串。
bstrDescription
[in]指定應用程式描述的字串。
bstrContactInfo
[in]指定此應用程式的連絡人資訊的字串。
bstrContactInfo
[in]指定此應用程式的連絡人資訊的字串。
bstrUserGroupName
[in]指定應用程式使用者組名的字串。 這個參數必須是有效的全域群組。
bstrUserGroupName
[in]指定應用程式使用者組名的字串。 這個參數必須是有效的全域群組。
bstrAdminGroupName
[in]指定應用程式管理員組名的字串。 這個參數必須是有效的全域群組。 如果以應用程式系統管理員身分執行，便會忽略這個參數。
bstrAdminGroupName
[in]指定應用程式管理員組名的字串。 這個參數必須是有效的全域群組。 如果以應用程式系統管理員身分執行，便會忽略這個參數。
lFlags
[in]指定是否啟用應用程式的整數。 若要啟用應用程式，請設定 SSO_FLAG_ENABLED 旗標。
lFlags
[in]指定是否啟用應用程式的整數。 若要啟用應用程式，請設定 SSO_FLAG_ENABLED 旗標。
lFlagMask
[in]若要變更旗標值，請將此遮罩設定為您需要變更的旗標。 例如，要啟用或停用「企業單一登入」，請將這個旗標設定為 SSO_FLAG_ENABLED。 flagMask參數會指出您想要變更的旗標，而flags參數則表示該旗標的新值。
lFlagMask
[in]若要變更旗標值，請將此遮罩設定為您需要變更的旗標。 例如，要啟用或停用「企業單一登入」，請將這個旗標設定為 SSO_FLAG_ENABLED。 flagMask參數會指出您想要變更的旗標，而flags參數則表示該旗標的新值。
傳回值
這個方法會傳回 HRESULT，指出它是否已成功完成。 如需詳細資訊，請參閱「錯誤值」一節。
不適用。
錯誤值
這個方法會傳回 HRESULT，其中包含下表的一個值。
此方法會將全域 Err 物件的 Number 屬性設定為下表中的其中一個值，以指出錯誤。
| 值 | 描述 |
|---|---|
| S_OK | 此方法已成功。 |
| E_ACCESSDENIED | 拒絕呼叫者的存取。 |
| E_INVALIDARG | 偵測到無效的參數。 |
備註
若要存取此方法，您必須是 SSO 系統管理員、SSO 分支機構系統管理員，或是應用程式系統管理員。
規格需求
平臺：Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows 11和Windows 10