WTSUSERCONFIGA 구조체(wtsapi32.h)

도메인 컨트롤러 또는 RD 세션 호스트(원격 데스크톱 세션 호스트) 서버의 사용자에 대한 구성 정보를 포함합니다. 이 구조체는 WTSQueryUserConfig 및 WTSSetUserConfig 함수에서 사용됩니다.

통사론

typedef struct _WTSUSERCONFIGA {
  DWORD Source;
  DWORD InheritInitialProgram;
  DWORD AllowLogonTerminalServer;
  DWORD TimeoutSettingsConnections;
  DWORD TimeoutSettingsDisconnections;
  DWORD TimeoutSettingsIdle;
  DWORD DeviceClientDrives;
  DWORD DeviceClientPrinters;
  DWORD ClientDefaultPrinter;
  DWORD BrokenTimeoutSettings;
  DWORD ReconnectSettings;
  DWORD ShadowingSettings;
  DWORD TerminalServerRemoteHomeDir;
  CHAR  InitialProgram[MAX_PATH + 1];
  CHAR  WorkDirectory[MAX_PATH + 1];
  CHAR  TerminalServerProfilePath[MAX_PATH + 1];
  CHAR  TerminalServerHomeDir[MAX_PATH + 1];
  CHAR  TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1];
} WTSUSERCONFIGA, *PWTSUSERCONFIGA;

회원

Source

WTSQueryUserConfig 함수에서 반환하는 구성 정보의 원본을 지정하는 WTS_CONFIG_SOURCE 열거형 형식의 값입니다.

InheritInitialProgram

클라이언트가 초기 프로그램을 지정할 수 있는지 여부를 나타내는 값입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

클라이언트에서 초기 프로그램을 지정할 수 없습니다. 대신 사용자가 서버에 로그온할 때 InitialProgram 멤버로 지정된 프로그램이 자동으로 시작됩니다. 서버는 사용자가 해당 프로그램을 종료할 때 사용자를 로그오프합니다.

1

클라이언트는 초기 프로그램을 지정할 수 있습니다.

AllowLogonTerminalServer

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

0

사용자가 로그온할 수 없습니다.

1

사용자가 로그온할 수 있습니다.

TimeoutSettingsConnections

최대 연결 기간(밀리초)입니다. 연결이 만료되기 1분 전에 서버는 보류 중인 연결 끊김에 대해 사용자에게 알깁니다. 연결 시간이 초과되면 서버는 BrokenTimeoutSettings 멤버로 지정된 작업을 수행합니다. 사용자가 로그온할 때마다 타이머가 다시 설정됩니다. 값이 0이면 연결 타이머를 사용할 수 없음을 나타냅니다.

TimeoutSettingsDisconnections

로그온이 종료되기 전에 서버에서 연결이 끊긴 세션을 유지하는 최대 기간(밀리초)입니다. 값이 0이면 연결 끊김 타이머를 사용할 수 없음을 나타냅니다.

TimeoutSettingsIdle

연결이 유휴 상태로 유지될 수 있는 시간(밀리초)입니다. 이 기간 동안 키보드 또는 마우스 작업이 없으면 서버는 BrokenTimeoutSettings 멤버로 지정된 작업을 수행합니다. 값이 0이면 유휴 타이머를 사용할 수 없음을 나타냅니다.

DeviceClientDrives

이 멤버는 예약되어 있습니다.

DeviceClientPrinters

사용자가 서버에 로그온할 때 서버가 이전에 매핑된 클라이언트 프린터에 자동으로 연결되는지 여부를 나타내는 값입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

서버는 이전에 매핑된 클라이언트 프린터에 자동으로 연결되지 않습니다.

1

서버는 이전에 매핑된 클라이언트 프린터에 자동으로 연결됩니다.

ClientDefaultPrinter

클라이언트 프린터가 기본 프린터인지 여부를 나타내는 값입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

클라이언트 프린터가 기본 프린터가 아닙니다.

1

클라이언트 프린터가 기본 프린터입니다.

BrokenTimeoutSettings

연결 또는 유휴 타이머가 만료되거나 연결 오류로 인해 연결이 끊어질 때 서버가 수행하는 작업입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

세션의 연결이 끊어졌지만 서버에 남아 있습니다.

1

세션이 종료됩니다.

ReconnectSettings

이 사용자의 연결이 끊긴 세션을 다시 연결하는 방법을 나타내는 값입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

사용자는 연결이 끊긴 세션에 다시 연결하기 위해 모든 클라이언트 컴퓨터에 로그온할 수 있습니다.

1

사용자는 연결이 끊긴 세션을 설정하는 데 원래 사용된 클라이언트 컴퓨터에 로그온해야 합니다. 사용자가 다른 클라이언트 컴퓨터에 로그온하는 경우 사용자는 새 세션을 가져옵니다.

ShadowingSettings

원격 제어 설정입니다. 원격 제어를 사용하면 사용자가 다른 사용자의 화면 작업을 원격으로 모니터링할 수 있습니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

원격 제어를 사용할 수 없습니다.

1

원격 제어 사용자는 사용자의 권한으로 사용자 세션을 완전히 제어할 수 있습니다.

2

원격 제어 사용자는 사용자의 세션을 완전히 제어할 수 있습니다. 사용자의 권한이 필요하지 않습니다.

3

원격 제어 사용자는 사용자의 권한으로 세션을 원격으로 볼 수 있습니다. 원격 사용자가 세션을 적극적으로 제어할 수 없습니다.

4

원격 제어 사용자는 세션을 원격으로 볼 수 있지만 세션을 적극적으로 제어할 수는 없습니다. 사용자의 권한이 필요하지 않습니다.

TerminalServerRemoteHomeDir

TerminalServerHomeDir 멤버에 로컬 디렉터리 또는 네트워크 공유에 대한 경로가 포함되어 있는지 여부를 나타내는 값입니다. WTSSetUserConfig 함수를 사용하여 이 멤버를 설정할 수 없습니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

TerminalServerHomeDir 멤버는 로컬 디렉터리에 대한 경로를 포함합니다.

1

TerminalServerHomeDir 멤버는 네트워크 공유에 대한 경로를 포함하고 TerminalServerHomeDirDrive 멤버에는 이 경로가 매핑되는 드라이브 문자가 포함되어 있습니다.

InitialProgram[MAX_PATH + 1]

사용자가 서버에 로그온한 직후 시작할 프로그램 이름이 포함된 null로 끝나는 문자열입니다.

WorkDirectory[MAX_PATH + 1]

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

TerminalServerProfilePath[MAX_PATH + 1]

사용자가 서버에 연결할 때 사용자에게 할당되는 프로필 경로가 포함된 null로 끝나는 문자열입니다. 경로에 지정된 디렉터리를 수동으로 만들어야 하며 로그온하기 전에 있어야 합니다.

TerminalServerHomeDir[MAX_PATH + 1]

사용자의 원격 데스크톱 서비스 세션의 홈 폴더에 대한 경로를 포함하는 null로 끝나는 문자열입니다. 폴더는 로컬 폴더 또는 네트워크 공유일 수 있습니다.

TerminalServerHomeDirDrive[WTS_DRIVE_LENGTH + 1]

TerminalServerHomeDir 멤버에 지정된 경로가 매핑되는 드라이브 이름(드라이브 문자 뒤에 콜론)이 포함된 null로 끝나는 문자열입니다. 이 멤버는 TerminalServerRemoteHomeDir 멤버가 1로 설정된 경우에만 유효합니다.

발언

메모

wtsapi32.h 헤더는 WTSUSERCONFIG를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 7
지원되는 최소 서버	Windows Server 2008 R2
헤더	wtsapi32.h

참고 항목

WTSQueryUserConfig

WTSSetUserConfig

WTS_CONFIG_SOURCE