다음을 통해 공유

WESL_UserSetting.SetCustomShell

  • 아티클
  • 적용 대상:
    ✅ Windows 11, ✅ Windows 10

이 메서드는 SID(보안 식별자)를 기반으로 특정 사용자 또는 그룹에 대한 셸 시작 관리자를 구성합니다.

구문

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

매개 변수

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

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

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

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

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

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

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

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

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

Return Value

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

설명

셸 시작 관리자는 CustomReturnCodes 및 CustomReturnCodesAction 배열을 사용하여 셸 애플리케이션의 반환 값을 기반으로 셸 애플리케이션이 종료될 때 시스템 동작을 결정합니다.

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

요구 사항

Windows 버전 지원됨
Windows Home 아니요
Windows Pro 아니요
Windows Enterprise 예
Windows Education 예
Windows IoT Enterprise 예