CreateFieldInfo 메서드는 애플리케이션에 대한 필드 정보를 만듭니다.
문법
HRESULT CreateFieldInfo(
BSTR bstrApplicationName,
BSTR bstrLabel,
LONG lFlags
);
Sub CreateFieldInfo(
bstrApplicationName As String,
bstrLabel As String,
lFlags As Long
)
매개 변수
bstrApplicationName
[in] 애플리케이션 이름을 지정하는 문자열입니다. 이 매개 변수는 NULL, 빈 문자열 또는 공백을 포함할 수 없습니다. 애플리케이션 이름은 대/소문자를 구분하지 않지만 대/소문자는 유지됩니다. 예를 들어 ABC, abc 및 AbC는 동일한 애플리케이션으로 간주됩니다.
bstrApplicationName
[in] 애플리케이션 이름을 지정하는 문자열입니다. 이 매개 변수는 NULL, 빈 문자열 또는 공백을 포함할 수 없습니다. 애플리케이션 이름은 대/소문자를 구분하지 않지만 대/소문자는 유지됩니다. 예를 들어 ABC, abc 및 AbC는 동일한 애플리케이션으로 간주됩니다.
bstrLabel
[in] 레이블 값을 지정하는 문자열입니다. 이 매개 변수는 NULL 또는 빈 문자열일 수 없습니다.
bstrLabel
[in] 레이블 값을 지정하는 문자열입니다. 이 매개 변수는 NULL 또는 빈 문자열일 수 없습니다.
lFlags
[in] 긴 정수는 필드가 마스킹되는지 여부를 지정합니다. 사용자 인터페이스에 표시될 때 필드를 마스킹해야 하는 경우 SSO_FLAG_FIELD_INFO_MASK 지정합니다. 플래그 매개 변수는 마스킹되지 않으므로 첫 번째(사용자 ID) 필드에 대해 무시됩니다.
lFlags
[in] 긴 정수는 필드가 마스킹되는지 여부를 지정합니다. 사용자 인터페이스에 표시될 때 필드를 마스킹해야 하는 경우 SSO_FLAG_FIELD_INFO_MASK 지정합니다. 플래그 매개 변수는 마스킹되지 않으므로 첫 번째(사용자 ID) 필드에 대해 무시됩니다.
반환 값
이 메서드는 성공적으로 완료되었는지 여부를 나타내는 HRESULT를 반환합니다. 자세한 내용은 오류 값 섹션을 참조하세요.
적용할 수 없습니다.
오류 값
이 메서드는 다음 표의 값 중 하나를 포함하는 HRESULT를 반환합니다.
이 메서드는 전역 Err 개체의 Number 속성을 다음 표의 값 중 하나로 설정하여 오류를 나타냅니다.
| 가치 | 설명 |
|---|---|
| S_OK | 메서드가 성공했습니다. |
| E_ACCESSDENIED | 호출자에 대한 액세스가 거부됩니다. |
| E_INVALIDARG (잘못된 인수) | 잘못된 매개 변수가 검색되었습니다. |
비고
필드 정보를 만들려면 먼저 애플리케이션이 있어야 합니다. 추가된 필드 수는 애플리케이션을 만들 때 지정된 numFields 값과 같아야 합니다. 그렇지 않으면 런타임에 애플리케이션을 사용하지 않도록 설정됩니다.
외부 사용자 ID는 외부 자격 증명으로 간주되지 않지만 사용자 인터페이스에서 표시하는 방법을 설명하는 필드가 필요합니다. 만든 첫 번째 필드는 외부 사용자 ID를 설명하는 필드로 간주됩니다. 하나 이상의 필드가 필요하며 일반적으로 자격 증명을 제공하려면 두 개 이상의 필드를 지정해야 합니다. 애플리케이션에는 자격 증명이 없을 수 있습니다.
이 메서드에 액세스하려면 SSO 관리자, SSO 관련 관리자 또는 SSO 애플리케이션 관리자여야 합니다.
요구 사항
플랫폼: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 및 Windows 10
또한 참조하십시오
Enterprise Single Sign-On을 사용한 프로그래밍
ISSOAdmin 인터페이스(COM)
ISSOAdmin 멤버