WTSLISTENERCONFIGA 구조체(wtsapi32.h)

원격 데스크톱 서비스 수신기에 대한 정보를 포함합니다. 이 구조체는 WTSCreateListener 함수에서 사용됩니다.

구문

typedef struct _WTSLISTENERCONFIGA {
  ULONG version;
  ULONG fEnableListener;
  ULONG MaxConnectionCount;
  ULONG fPromptForPassword;
  ULONG fInheritColorDepth;
  ULONG ColorDepth;
  ULONG fInheritBrokenTimeoutSettings;
  ULONG BrokenTimeoutSettings;
  ULONG fDisablePrinterRedirection;
  ULONG fDisableDriveRedirection;
  ULONG fDisableComPortRedirection;
  ULONG fDisableLPTPortRedirection;
  ULONG fDisableClipboardRedirection;
  ULONG fDisableAudioRedirection;
  ULONG fDisablePNPRedirection;
  ULONG fDisableDefaultMainClientPrinter;
  ULONG LanAdapter;
  ULONG PortNumber;
  ULONG fInheritShadowSettings;
  ULONG ShadowSettings;
  ULONG TimeoutSettingsConnection;
  ULONG TimeoutSettingsDisconnection;
  ULONG TimeoutSettingsIdle;
  ULONG SecurityLayer;
  ULONG MinEncryptionLevel;
  ULONG UserAuthentication;
  CHAR  Comment[WTS_COMMENT_LENGTH + 1];
  CHAR  LogonUserName[USERNAME_LENGTH + 1];
  CHAR  LogonDomain[DOMAIN_LENGTH + 1];
  CHAR  WorkDirectory[MAX_PATH + 1];
  CHAR  InitialProgram[MAX_PATH + 1];
} WTSLISTENERCONFIGA, *PWTSLISTENERCONFIGA;

멤버

version

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

fEnableListener

수신기를 사용할 수 있는지 여부를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

수신기를 사용할 수 없습니다.

1

수신기를 사용할 수 있습니다.

MaxConnectionCount

수신기가 허용하는 활성 연결의 최대 수입니다.

fPromptForPassword

수신기가 항상 사용자에게 암호를 묻는 메시지를 표시할지 여부를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

서버에서 지정한 경우에만 사용자에게 암호를 묻는 메시지를 표시합니다.

1

항상 사용자에게 암호를 묻는 메시지를 표시합니다.

fInheritColorDepth

수신기가 사용자가 지정한 색 깊이를 사용할지 여부를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

서버에서 지정한 색 깊이를 사용합니다.

1

사용자가 지정한 색 깊이를 사용합니다.

ColorDepth

수신기의 색 깊이 설정입니다. 이 설정은 fInheritColorDepth 멤버가 0인 경우에만 적용됩니다. 다음 값 중 하나일 수 있습니다.

1

8비트

2

15비트

3

16비트

4

24비트

5

32비트

fInheritBrokenTimeoutSettings

수신기가 사용자가 지정한 BrokenTimeoutSettings 값을 사용할지 여부를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

서버에서 지정한 BrokenTimeoutSettings 값을 사용합니다.

1

사용자가 지정한 BrokenTimeoutSettings 값을 사용합니다.

BrokenTimeoutSettings

연결 또는 유휴 타이머가 만료되거나 연결 오류로 인해 연결이 끊어질 때 수신기가 수행하는 작업입니다. 이 설정은 fInheritBrokenTimeoutSettings 멤버가 0인 경우에만 적용됩니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

연결 또는 유휴 타이머가 만료되거나 연결 오류로 인해 연결이 끊어진 경우 사용자는 연결이 끊어지지만 세션은 서버에 남아 있습니다.

1

연결 또는 유휴 타이머가 만료되거나 연결 오류로 인해 연결이 끊어지면 세션이 종료됩니다.

fDisablePrinterRedirection

프린터 리디렉션을 사용하지 않도록 설정할지 여부를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

사용자는 프린터 리디렉션을 사용하도록 설정할 수 있습니다.

1

프린터 리디렉션을 사용할 수 없습니다.

fDisableDriveRedirection

드라이브 리디렉션을 사용하지 않도록 설정할지 여부를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

사용자는 드라이브 리디렉션을 사용하도록 설정할 수 있습니다.

1

드라이브 리디렉션을 사용할 수 없습니다.

fDisableComPortRedirection

COM 포트 리디렉션을 사용하지 않도록 설정할지 여부를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

사용자는 COM 포트 리디렉션을 사용하도록 설정할 수 있습니다.

1

COM 포트 리디렉션을 사용할 수 없습니다.

fDisableLPTPortRedirection

LPT 포트 리디렉션을 사용하지 않도록 설정할지 여부를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

사용자는 LPT 포트 리디렉션을 사용하도록 설정할 수 있습니다.

1

LPT 포트 리디렉션을 사용할 수 없습니다.

fDisableClipboardRedirection

클립보드 리디렉션을 사용하지 않도록 설정할지 여부를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

사용자는 클립보드 리디렉션을 사용하도록 설정할 수 있습니다.

1

클립보드 리디렉션을 사용할 수 없습니다.

fDisableAudioRedirection

오디오 리디렉션을 사용하지 않도록 설정할지 여부를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

사용자는 오디오 리디렉션을 사용하도록 설정할 수 있습니다.

1

오디오 리디렉션을 사용할 수 없습니다.

fDisablePNPRedirection

플러그 앤 플레이 리디렉션을 사용하지 않도록 설정할지 여부를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

사용자는 플러그 앤 플레이 리디렉션을 사용하도록 설정할 수 있습니다.

1

플러그 앤 플레이 리디렉션을 사용할 수 없습니다.

fDisableDefaultMainClientPrinter

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

0

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

1

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

LanAdapter

수신기에서 사용하는 네트워크 어댑터입니다.

PortNumber

수신기의 포트 번호입니다.

fInheritShadowSettings

수신기가 사용자가 지정한 ShadowSettings 값을 사용해야 하는지 여부를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

서버에서 지정한 설정을 사용합니다.

1

사용자가 지정한 설정을 사용합니다.

ShadowSettings

수신기에 대한 원격 제어 설정입니다. 원격 제어를 사용하면 사용자가 다른 사용자의 화면 작업을 원격으로 모니터링할 수 있습니다. 이 설정은 fInheritShadowSettings 멤버가 0인 경우에만 적용됩니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

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

1

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

2

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

3

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

4

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

TimeoutSettingsConnection

최대 연결 기간(밀리초)입니다. 사용자가 로그온할 때마다 타이머가 다시 설정됩니다. 값이 0이면 연결 타이머를 사용할 수 없음을 나타냅니다.

TimeoutSettingsDisconnection

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

TimeoutSettingsIdle

최대 유휴 시간(밀리초)입니다. 값이 0이면 유휴 타이머를 사용할 수 없음을 나타냅니다.

SecurityLayer

수신기의 보안 계층입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

RDP(원격 데스크톱 프로토콜)는 연결이 설정되기 전에 서버와 클라이언트에서 인증에 사용됩니다.

1

서버와 클라이언트는 연결이 설정되기 전에 인증 방법을 협상합니다.

2

TLS(전송 계층 보안) 프로토콜은 연결이 설정되기 전에 서버와 클라이언트에서 인증에 사용됩니다.

MinEncryptionLevel

수신기의 암호화 수준입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

1

클라이언트에서 서버로 전송된 데이터는 56비트 암호화를 사용하여 암호화됩니다. 서버에서 클라이언트로 전송된 데이터는 암호화되지 않습니다.

2

클라이언트에서 서버로, 서버에서 클라이언트로 전송되는 모든 데이터는 클라이언트에서 지원하는 최대 키 강도를 사용하여 암호화됩니다.

3

클라이언트에서 서버로, 서버에서 클라이언트로 전송되는 모든 데이터는 128비트 암호화를 사용하여 암호화됩니다. 이 수준의 암호화를 지원하지 않는 클라이언트는 연결할 수 없습니다.

4

클라이언트에서 서버로, 서버에서 클라이언트로 전송되는 모든 데이터는 FIPS(Federal Information Processing Standards) 암호화 알고리즘 및 Microsoft 암호화 모듈을 사용하여 암호화 및 암호 해독됩니다.

UserAuthentication

연결이 설정되기 전에 네트워크 수준 사용자 인증이 필요한지 여부를 지정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

0

네트워크 수준 사용자 인증은 필요하지 않습니다.

1

네트워크 수준 사용자 인증이 필요합니다.

Comment[WTS_COMMENT_LENGTH + 1]

수신기에 대한 설명을 포함하는 null로 끝나는 문자열입니다.

LogonUserName[USERNAME_LENGTH + 1]

자동 로그온 시나리오에 사용되는 사용자 이름을 포함하는 null로 끝나는 문자열입니다.

LogonDomain[DOMAIN_LENGTH + 1]

자동 로그온 시나리오에 사용되는 도메인 이름을 포함하는 null로 끝나는 문자열입니다.

WorkDirectory[MAX_PATH + 1]

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

InitialProgram[MAX_PATH + 1]

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

설명

참고

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

요구 사항

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

추가 정보

WTSCreateListener