WTS_CONFIG_CLASS 열거형(wtsapi32.h)

아티클
08/28/2023

WTSQueryUserConfig 및 WTSSetUserConfig 함수에 대한 호출에서 설정하거나 검색할 사용자 구성 정보의 유형을 나타내는 값을 포함합니다.

Syntax

typedef enum _WTS_CONFIG_CLASS {
  WTSUserConfigInitialProgram,
  WTSUserConfigWorkingDirectory,
  WTSUserConfigfInheritInitialProgram,
  WTSUserConfigfAllowLogonTerminalServer,
  WTSUserConfigTimeoutSettingsConnections,
  WTSUserConfigTimeoutSettingsDisconnections,
  WTSUserConfigTimeoutSettingsIdle,
  WTSUserConfigfDeviceClientDrives,
  WTSUserConfigfDeviceClientPrinters,
  WTSUserConfigfDeviceClientDefaultPrinter,
  WTSUserConfigBrokenTimeoutSettings,
  WTSUserConfigReconnectSettings,
  WTSUserConfigModemCallbackSettings,
  WTSUserConfigModemCallbackPhoneNumber,
  WTSUserConfigShadowingSettings,
  WTSUserConfigTerminalServerProfilePath,
  WTSUserConfigTerminalServerHomeDir,
  WTSUserConfigTerminalServerHomeDirDrive,
  WTSUserConfigfTerminalServerRemoteHomeDir,
  WTSUserConfigUser
} WTS_CONFIG_CLASS;

상수

WTSUserConfigInitialProgram
원격 데스크톱 서비스가 실행될 때 실행되는 초기 프로그램의 경로를 포함하는 null로 종료된 문자열입니다.
사용자 로그온

WTSUserConfigfInheritInitialProgram 값이 1이면 초기 프로그램이 될 수 있습니다.
클라이언트에서 지정한 모든 프로그램입니다.

WTSUserConfigWorkingDirectory
초기 프로그램의 작업 디렉터리 경로를 포함하는 null로 끝나는 문자열입니다.

WTSUserConfigfInheritInitialProgram
클라이언트가 초기 프로그램을 지정할 수 있는지 여부를 나타내는 값입니다.

값	의미
0	클라이언트는 초기 프로그램을 지정할 수 없습니다. 대신 WTSUserConfigInitialProgram 문자열은 실행되는 초기 프로그램을 식별합니다. 사용자가 원격 컴퓨터에 로그온할 때 자동으로 적용됩니다. 원격 데스크톱 서비스는 사용자가 로그오프할 때 사용자를 로그오프합니다. 이 프로그램을 종료합니다.
1	클라이언트는 초기 프로그램을 지정할 수 있습니다.

WTSUserConfigfAllowLogonTerminalServer
사용자 계정이 RD 세션 호스트 서버에 로그온할 수 있는지 여부를 나타내는 값입니다.

값	의미
0	사용자가 로그온할 수 없습니다.
1	사용자가 로그온할 수 있습니다.

WTSUserConfigTimeoutSettingsConnections
최대 연결 기간을 밀리초 단위로 지정하는 DWORD 값입니다.
연결 시간 제한 간격이 만료되기 1분 전에 사용자에게 보류 중인 연결 끊김에 대한 알림이 표시됩니다.
사용자의 세션은 에 따라 연결이 끊어지거나 종료됩니다.
WTSUserConfigBrokenTimeoutSettings 값입니다 . 사용자가 로그온할 때마다 타이머는
재설정. 값이 0이면 연결 타이머가 비활성화되었음을 나타냅니다.

WTSUserConfigTimeoutSettingsDisconnections
최대 기간을 밀리초 단위로 지정하는 DWORD 값입니다.
RD 세션 호스트 서버는 로그온이 종료되기 전에 연결이 끊긴 세션을 유지합니다. 값이 0이면
연결 끊김 타이머를 사용할 수 없습니다.

WTSUserConfigTimeoutSettingsIdle
최대 유휴 시간(밀리초)을 지정하는 DWORD 값입니다. 있는 경우
지정된 간격에 대한 키보드 또는 마우스 활동이 없으므로 사용자의 세션 연결이 끊어지거나 종료됩니다.
WTSUserConfigBrokenTimeoutSettings 값에 따라 다릅니다. 값이 0입니다.
는 유휴 타이머가 비활성화되었음을 나타냅니다.

WTSUserConfigfDeviceClientDrives
이 상수는 현재 원격 데스크톱 서비스에서 사용되지 않습니다.

RD 세션 호스트 서버가 자동으로 다시 설정되는지 여부를 나타내는 값입니다.
로그온 시 클라이언트 드라이브 매핑

값	의미
0	서버는 이전에 매핑된 클라이언트 드라이브에 자동으로 연결되지 않습니다.
1	서버는 로그온 시 이전에 매핑된 클라이언트 드라이브에 자동으로 연결됩니다.

WTSUserConfigfDeviceClientPrinters
RDP 5.0 이상 클라이언트: RD 세션 호스트 서버인지 여부를 나타내는 값입니다.
로그온 시 클라이언트 프린터 매핑을 자동으로 다시 설정합니다.

값	의미
0	서버는 이전에 매핑된 클라이언트 프린터에 자동으로 연결되지 않습니다.
1	서버는 로그온 시 이전에 매핑된 클라이언트 프린터에 자동으로 연결됩니다.

WTSUserConfigfDeviceClientDefaultPrinter
RDP 5.0 이상 클라이언트: 클라이언트 프린터 여부를 나타내는 값입니다.
은 기본 프린터입니다.

값	의미
0	클라이언트 프린터가 기본 프린터가 아닙니다.
1	클라이언트 프린터는 기본 프린터입니다.

WTSUserConfigBrokenTimeoutSettings
연결 또는 유휴 타이머가 만료되거나 연결이 끊어질 때 발생하는 일을 나타내는 값입니다.
연결 오류로 인한 것입니다.

값	의미
0	세션 연결이 끊어졌습니다.
1	세션이 종료됩니다.

WTSUserConfigReconnectSettings
이 사용자의 연결이 끊긴 세션을 다시 연결하는 방법을 나타내는 값입니다.

값	의미
0	사용자는 모든 클라이언트 컴퓨터에 로그온하여 연결이 끊긴 세션에 다시 연결할 수 있습니다.
1	사용자가 설정하는 데 사용되는 클라이언트 컴퓨터에 로그온하여 연결이 끊긴 세션에 다시 연결할 수 있습니다. 연결이 끊긴 세션입니다. 사용자가 다른 클라이언트 컴퓨터에서 로그온하는 경우 사용자는 새 로그온을 가져옵니다. 세션.

WTSUserConfigModemCallbackSettings
이 상수는 현재 원격 데스크톱 서비스에서 사용되지 않습니다.

에서 전화 접속 연결에 대한 구성을 나타내는 값입니다.
RD 세션 호스트 서버는 응답을 중지한 다음 클라이언트를 다시 호출하여 연결을 설정합니다.

값	의미
0	콜백 연결은 사용하지 않도록 설정됩니다.
1	서버는 사용자에게 전화 번호를 입력하라는 메시지를 표시하고 해당 전화 번호로 사용자를 다시 호출합니다. 이 문서의 설명에 따라 Azure Automation Hybrid Runbook Worker를 제거할 수 있습니다. WTSUserConfigModemCallbackPhoneNumber 값을 사용하여 기본 휴대폰 지정 번호를 통해 확인할 수 있습니다.
2	서버는 에서 지정한 전화 번호로 사용자를 자동으로 다시 호출합니다. WTSUserConfigModemCallbackPhoneNumber 값입니다.

WTSUserConfigModemCallbackPhoneNumber
이 상수는 현재 원격 데스크톱 서비스에서 사용되지 않습니다.

콜백에 사용할 전화 번호가 포함된 null로 종료된 문자열
포함합니다.

WTSUserConfigShadowingSettings
RDP 5.0 이상 클라이언트: 사용자 세션 여부를 나타내는 값입니다.
그림자를 지정할 수 있습니다. 섀도를 사용하면 사용자가 다른 사용자의 화면 작업을 원격으로 모니터링할 수 있습니다.

값	의미
0	사용 중지
1	입력 사용, 알림
2	입력 사용, 알림 없음
3	입력 없음, 알림 사용
4	입력 없음, 알림 없음 사용

WTSUserConfigTerminalServerProfilePath
RD 세션 호스트 서버 로그온에 대한 사용자 프로필의 경로를 포함하는 null로 종료된 문자열입니다. 디렉터리
식별되는 경로는 수동으로 만들어야 하며 로그온하기 전에 있어야 합니다.
WTSSetUserConfig 는 디렉터리를 만들지 않습니다.
아직 없는 경우 입니다.

WTSUserConfigTerminalServerHomeDir
RD 세션 호스트 서버 로그온에 대한 사용자의 루트 디렉터리 경로를 포함하는 null로 종료된 문자열입니다. 이번
string은 로컬 경로 또는 UNC 경로(\ComputerName\Share\Path)를 지정할 수 있습니다. 자세한 내용은
WTSUserConfigfTerminalServerRemoteHomeDir.

WTSUserConfigTerminalServerHomeDirDrive
UNC가 있는 드라이브 이름(드라이브 문자 뒤에 콜론)이 포함된 null로 끝나는 문자열입니다.
WTSUserConfigTerminalServerHomeDir 문자열에 지정된 경로가 매핑됩니다. 자세한 내용은
WTSUserConfigfTerminalServerRemoteHomeDir.

WTSUserConfigfTerminalServerRemoteHomeDir
RD 세션 호스트 서버 로그온에 대한 사용자의 루트 디렉터리가 로컬 경로인지 아니면 인지를 나타내는 값입니다.
매핑된 드라이브 문자입니다. 이 값은 와 함께 사용할 수 없습니다.
WTSSetUserConfig.

값	의미
0	WTSUserConfigTerminalServerHomeDir 문자열에는 의 로컬 경로가 포함됩니다. 사용자의 RD 세션 호스트 서버 로그온 루트 디렉터리입니다.
1	WTSUserConfigTerminalServerHomeDir 문자열에는 의 UNC 경로가 포함됩니다. 사용자의 RD 세션 호스트 서버 로그온 루트 디렉터리 및 WTSUserConfigTerminalServerHomeDirDrive 문자열에는 드라이브 문자가 포함되어 있습니다. UNC 경로가 매핑됩니다.

WTSUserConfigUser
세션에 대한 구성 데이터를 포함하는 WTSUSERCONFIG 구조체입니다.

Windows Server 2008 및 Windows Vista: 이 값은 지원되지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
머리글	wtsapi32.h

추가 정보

WTSQueryUserConfig

WTSSetUserConfig

다음을 통해 공유

WTS_CONFIG_CLASS 열거형(wtsapi32.h)

Syntax

상수

요구 사항

추가 정보

피드백

추가 리소스