WESL_UserSetting.GetCustomShell

이 메서드는 SID(보안 식별자)를 기반으로 특정 사용자 또는 그룹에 대한 Shell Launcher 구성을 검색합니다.

구문

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

매개 변수

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

[out, 필수] 셸 시작 관리자 애플리케이션 또는 실행 파일이 셸로 시작됩니다.

CustomReturnCodes [out, required] 셸 애플리케이션에서 반환된 사용자 지정 반환 코드의 배열입니다.

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

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

Description

0

셸을 다시 시작합니다.

1

디바이스를 다시 시작합니다.

2

디바이스를 종료합니다.

3

아무 작업도 하지 않습니다.

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

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

Description

0

셸을 다시 시작합니다.

1

디바이스를 다시 시작합니다.

2

디바이스를 종료합니다.

3

아무 작업도 하지 않습니다.

반환 값

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

설명

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

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

요구 사항

Windows 버전 지원됨
Windows 10 Home 아니요
Windows 10 Pro
Windows 10 Enterprise Yes
Windows 10 Education

WESL_UserSetting

셸 시작 관리자