다음을 통해 공유

WESL_UserSetting.SetCustomShell

이 메서드는 SID(보안 식별자)에 따라 특정 사용자 또는 그룹에 대해 Shell Launcher를 구성합니다.

구문

[Static] uint32 SetCustomShell (
    [In, Required] string Sid,
    [In, Required] string Shell,
    [In] sint32 CustomReturnCodes[],
    [In] sint32 CustomReturnCodesAction[],
    [In] sint32 DefaultAction
);

매개 변수

Sid
[in, required] 셸 시작 관리자가 구성되는 사용자 또는 그룹의 SID(보안 식별자)를 포함하는 문자열입니다.

포탄
[in, required] 셸 시작 관리자가 셸로 시작하는 애플리케이션 또는 실행 파일입니다.

CustomReturnCodes
[in] 셸 애플리케이션에서 반환할 수 있는 사용자 지정 반환 코드의 배열입니다.

CustomReturnCodesAction
[in] 셸 애플리케이션이 종료되면 셸 시작 관리자가 수행하는 작업을 결정하는 사용자 지정 반환 코드 작업의 배열입니다. 사용자 지정 작업은 CustomReturnCodes의 배열에 매핑됩니다.

가능한 작업은 다음 표에 정의되어 있습니다.

값 설명
0 셸을 다시 시작합니다.
1 디바이스를 다시 시작합니다.
2 디바이스를 종료합니다.
3 아무것도 하지 않습니다.

DefaultAction
[In] 셸 애플리케이션이 종료되면 셸 시작 관리자가 수행하는 기본 작업입니다.

가능한 작업은 다음 표에 정의되어 있습니다.

값 설명
0 셸을 다시 시작합니다.
1 디바이스를 다시 시작합니다.
2 디바이스를 종료합니다.
3 아무것도 하지 않습니다.

반환 값

WMI 상태 또는 WMI 오류를 나타내는 HRESULT 값을 반환합니다.

설명

셸 시작 관리자에서는 CustomReturnCodes 및 CustomReturnCodesAction 배열을 사용하여 셸 애플리케이션의 반환 값에 따라 셸 애플리케이션이 종료되면 시스템 동작을 결정합니다.

반환 값이 CustomReturnCodes에 없거나 CustomReturnCodesAction에 정의된 해당 작업이 유효한 값이 아닌 경우 셸 시작 관리자에서 DefaultAction을 사용하여 시스템 동작을 확인합니다. DefaultAction이 정의되지 않았거나 유효한 값이 아닌 경우 셸 시작 관리자가 셸 애플리케이션을 다시 시작합니다.

요구 사항

Windows 버전 지원함
Windows Home 아니오
Windows Pro 아니오
Windows Enterprise 예
Windows Education 예
Windows IoT Enterprise 예