ISSOAdmin.CreateApplication 方法

CreateApplication方法會在 Enterprise 單一 Sign-On (SSO) server 資料庫中建立應用程式。

語法

  
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
在指定應用程式描述的字串。 這個參數可以是 NULL 或空字串,或是包含空格。

bstrDescription
在指定應用程式描述的字串。 這個參數可以是 NULL 或空字串,或是包含空格。

bstrContactInfo
在字串,指定此應用程式的連絡人資訊。 這個參數可以是 NULL 或空字串,或是包含空格。

bstrContactInfo
在字串,指定此應用程式的連絡人資訊。 這個參數可以是 NULL 或空字串,或是包含空格。

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

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

bstrAdminGroupName
在指定應用程式系統管理員組名的字串。 這個參數必須包含有效的全域群組。

bstrAdminGroupName
在指定應用程式系統管理員組名的字串。 這個參數必須包含有效的全域群組。

lFlags
在指定應用程式是否為群組應用程式的長整數。 如果需要群組應用程式,則指定 SSO_FLAG_APP_USES_GROUP_MAPPING。

lFlags
在指定應用程式是否為群組應用程式的長整數。 如果需要群組應用程式,則指定 SSO_FLAG_APP_USES_GROUP_MAPPING。

lNumFields
在長整數,指定將為此應用程式加入的欄位數目。 最小值是 1 (一個外部使用者識別碼)。 應用程式不能有認證欄位。

lNumFields
在長整數,指定將為此應用程式加入的欄位數目。 最小值是 1 (一個外部使用者識別碼)。 應用程式不能有認證欄位。

傳回值

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

不適用。

錯誤值

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

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

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

備註

應用程式在建立時一定為停用。

使用 CreateFieldInfo 方法加入欄位資訊之後,就可以使用 UpdateApplication 方法來啟用應用程式。 CreateFieldInfo新增的欄位數目必須符合numFields參數所指定的欄位數目。 建立應用程式之後,就無法變更 numFields 值。

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

規格需求

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

另請參閱

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