WTSCreateListenerA 함수(wtsapi32.h)
새 원격 데스크톱 서비스 수신기를 만들거나 기존 수신기를 구성합니다.
통사론
BOOL WTSCreateListenerA(
[in] HANDLE hServer,
[in] PVOID pReserved,
[in] DWORD Reserved,
[in] LPSTR pListenerName,
[in] PWTSLISTENERCONFIGA pBuffer,
[in] DWORD flag
);
매개 변수
[in] hServer
RD 세션 호스트 서버에 대한 핸들입니다. 항상 이 매개 변수를 WTS_CURRENT_SERVER_HANDLE.
[in] pReserved
이 매개 변수는 예약되어 있습니다. 항상 이 매개 변수를 NULL
[in] Reserved
이 매개 변수는 예약되어 있습니다. 항상 이 매개 변수를 0으로 설정합니다.
[in] pListenerName
만들거나 구성할 수신기의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.
[in] pBuffer
수신기에 대한 구성 정보를 포함하는 WTSLISTENERCONFIG 구조체에 대한 포인터입니다.
[in] flag
호출의 목적입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
WTS_LISTENER_CREATE(1(0x1))
새 수신기를 만듭니다.
WTS_LISTENER_UPDATE(16(0x10))
기존 수신기의 설정을 업데이트합니다.
반환 값
함수가 성공하면 반환 값은 0이 아닌 값입니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError 함수를 호출합니다.
발언
이 함수는 RDP(원격 데스크톱 프로토콜)
이 함수는 수신기의 보안 설명자를 만들거나 구성하지 않습니다. 이 함수를 호출하여 새 수신기를 만들 때 함수는 새 수신기에 기본 보안 설명자를 할당합니다. 보안 설명자를 수정하려면 WTSSetListenerSecurity 함수를 호출합니다. 보안 설명자에 대한 자세한 내용은 SECURITY_DESCRIPTOR참조하세요.
이 함수는 새 수신기에 대한 설정의 유효성을 검사하지 않습니다. 이 함수를 호출하기 전에 설정이 유효한지 확인합니다.
메모
wtsapi32.h 헤더는 WTSCreateListener를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 |
| 지원되는 최소 서버 | Windows Server 2008 R2 |
| 대상 플랫폼 | Windows |
| 헤더 | wtsapi32.h |
| 라이브러리 | Wtsapi32.lib |
| DLL | Wtsapi32.dll |
참고 항목
WTSLISTENERCONFIG
WTSSetListenerSecurity