ISSOAdmin.CreateApplication 方法
CreateApplication方法會在 Enterprise Single Sign-On (SSO) 伺服器資料庫中建立應用程式。
語法
HRESULT CreateApplication(
BSTR bstrApplicationName,
BSTR bstrDescription,
BSTR bstrContactInfo,
BSTR bstrUserGroupName,
BSTR bstrAdminGroupName,
LONG lFlags,
LONG lNumFields
);
[Visual Basic]
Sub CreateApplication(
bstrApplicationName As String,
bstrDescription As String,
bstrContactInfo As String,
bstrUserGroupName As String,
bstrAdminGroupName As String,
lFlags As Long,
lNumFields As Long
)
參數
bstrApplicationName
[in] 指定應用程式名稱的字串。 這個參數不可以是 NULL 或空字串,或是包含空格。 應用程式名稱不區分大小寫,但是將會保留原來的大小寫。 例如,ABC、abc 和 AbC 都會被視為相同的應用程式。
bstrApplicationName
[in] 指定應用程式名稱的字串。 這個參數不可以是 NULL 或空字串,或是包含空格。 應用程式名稱不區分大小寫,但是將會保留原來的大小寫。 例如,ABC、abc 和 AbC 都會被視為相同的應用程式。
bstrDescription
[in]指定應用程式描述的字串。 這個參數可以是 NULL 或空字串,或是包含空格。
bstrDescription
[in]指定應用程式描述的字串。 這個參數可以是 NULL 或空字串,或是包含空格。
bstrContactInfo
[in]指定此應用程式的連絡人資訊的字串。 這個參數可以是 NULL 或空字串,或是包含空格。
bstrContactInfo
[in]指定此應用程式的連絡人資訊的字串。 這個參數可以是 NULL 或空字串,或是包含空格。
bstrUserGroupName
[in]指定應用程式使用者組名的字串。 這個參數必須包含有效的全域群組。
bstrUserGroupName
[in]指定應用程式使用者組名的字串。 這個參數必須包含有效的全域群組。
bstrAdminGroupName
[in]指定應用程式管理員組名的字串。 這個參數必須包含有效的全域群組。
bstrAdminGroupName
[in]指定應用程式管理員組名的字串。 這個參數必須包含有效的全域群組。
lFlags
[in]長整數,指定應用程式是否為群組應用程式。 如果需要群組應用程式,則指定 SSO_FLAG_APP_USES_GROUP_MAPPING。
lFlags
[in]長整數,指定應用程式是否為群組應用程式。 如果需要群組應用程式,則指定 SSO_FLAG_APP_USES_GROUP_MAPPING。
lNumFields
[in]長整數,指定要為此應用程式加入的欄位數目。 最小值是 1 (一個外部使用者識別碼)。 應用程式不能有認證欄位。
lNumFields
[in]長整數,指定要為此應用程式加入的欄位數目。 最小值是 1 (一個外部使用者識別碼)。 應用程式不能有認證欄位。
傳回值
這個方法會傳回 HRESULT,指出它是否已成功完成。 如需詳細資訊,請參閱「錯誤值」一節。
不適用。
錯誤值
這個方法會傳回 HRESULT,其中包含下表的一個值。
此方法會將全域 Err 物件的 Number 屬性設定為下表中的其中一個值,以指出錯誤。
值 | 描述 |
---|---|
S_OK | 此方法已成功。 |
E_ACCESSDENIED | 拒絕呼叫者的存取。 |
E_INVALIDARG | 偵測到無效的參數。 |
備註
應用程式在建立時一定為停用。
使用 CreateFieldInfo 方法新增欄位資訊之後,就可以使用 UpdateApplication 方法來啟用應用程式。 CreateFieldInfo所新增的欄位數目必須符合numFields參數所指定的欄位數目。 建立應用程式之後,就無法變更 numFields 值。
若要存取此方法,您必須是 SSO 系統管理員或 SSO 分支機構系統管理員。
規格需求
平臺:Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows 11和Windows 10