WTSLISTENERCONFIGW 구조체(wtsapi32.h)

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

구문

typedef struct _WTSLISTENERCONFIGW {
  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;
  WCHAR Comment[WTS_COMMENT_LENGTH + 1];
  WCHAR LogonUserName[USERNAME_LENGTH + 1];
  WCHAR LogonDomain[DOMAIN_LENGTH + 1];
  WCHAR WorkDirectory[MAX_PATH + 1];
  WCHAR InitialProgram[MAX_PATH + 1];
} WTSLISTENERCONFIGW, *PWTSLISTENERCONFIGW;

멤버

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

요구 사항

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

참고 항목

WTSCreateListener