다음을 통해 공유

WTSGetListenerSecurityA 함수(wtsapi32.h)

  • 아티클

원격 데스크톱 서비스 수신기의 보안 설명자를 검색합니다.

구문

BOOL WTSGetListenerSecurityA(
  [in]            HANDLE               hServer,
  [in]            PVOID                pReserved,
  [in]            DWORD                Reserved,
  [in]            LPSTR                pListenerName,
  [in]            SECURITY_INFORMATION SecurityInformation,
  [out, optional] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]            DWORD                nLength,
  [out]           LPDWORD              lpnLengthNeeded
);

매개 변수

[in] hServer

RD 세션 호스트 서버에 대한 핸들입니다. 항상 이 매개 변수를 WTS_CURRENT_SERVER_HANDLE.

[in] pReserved

이 매개 변수는 예약되어 있습니다. 항상 이 매개 변수를 NULL로 설정합니다.

[in] Reserved

이 매개 변수는 예약되어 있습니다. 항상 이 매개 변수를 0으로 설정합니다.

[in] pListenerName

수신기의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] SecurityInformation

검색할 보안 정보를 지정하는 SECURITY_INFORMATION 값입니다. 항상 DACL_SECURITY_INFORMATION 및 SACL_SECURITY_INFORMATION 플래그를 사용하도록 설정합니다.

가능한 값에 대한 자세한 내용은 SECURITY_INFORMATION.

[out, optional] pSecurityDescriptor

pListenerName 매개 변수에서 참조하는 수신기와 연결된 보안 정보를 수신하는 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다. SECURITY_DESCRIPTOR 구조체는 자체 상대 형식으로 반환됩니다. 가능한 값에 대한 자세한 내용은 SECURITY_DESCRIPTOR.

보안 설명자의 DACL(임의 액세스 제어 목록)에는 다음 값 중 하나 이상이 포함될 수 있습니다.

WTS_SECURITY_ALL_ACCESS

다음 값을 결합합니다.

  • STANDARD_RIGHTS_REQUIRED
  • WTS_SECURITY_CONNECT
  • WTS_SECURITY_DISCONNECT
  • WTS_SECURITY_LOGON
  • WTS_SECURITY_MESSAGE
  • WTS_SECURITY_QUERY_INFORMATION
  • WTS_SECURITY_REMOTE_CONTROL
  • WTS_SECURITY_RESET
  • WTS_SECURITY_SET_INFORMATION
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_CONNECT(256(0x100))

연결할 수 있는 권한입니다.

WTS_SECURITY_CURRENT_GUEST_ACCESS

다음 값을 결합합니다.

  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_CURRENT_USER_ACCESS

다음 값을 결합합니다.

  • WTS_SECURITY_DISCONNECT
  • WTS_SECURITY_LOGOFF
  • WTS_SECURITY_RESET
  • WTS_SECURITY_SET_INFORMATION
  • WTS_SECURITY_VIRTUAL_CHANNELS

WTS_SECURITY_DISCONNECT (512(0x200))

연결을 끊을 수 있는 권한입니다.

WTS_SECURITY_GUEST_ACCESS

WTS_SECURITY_LOGON 정의됩니다.

WTS_SECURITY_LOGOFF(64(0x40))

로그오프할 수 있는 권한입니다.

WTS_SECURITY_LOGON(32(0x20))

로그온할 수 있는 권한입니다.

WTS_SECURITY_MESSAGE(128(0x80))

사용자에게 메시지를 보낼 수 있는 권한입니다.

WTS_SECURITY_QUERY_INFORMATION(1(0x1))

정보를 쿼리할 수 있는 권한입니다.

WTS_SECURITY_REMOTE_CONTROL(16(0x10))

원격 제어를 사용할 수 있는 권한입니다.

WTS_SECURITY_RESET(4(0x4))

정보를 재설정할 수 있는 권한입니다.

WTS_SECURITY_SET_INFORMATION(2(0x2))

정보를 설정할 수 있는 권한입니다.

WTS_SECURITY_USER_ACCESS

다음 값을 결합합니다.

  • WTS_SECURITY_CONNECT
  • WTS_SECURITY_CURRENT_GUEST_ACCESS
  • WTS_SECURITY_QUERY_INFORMATION

WTS_SECURITY_VIRTUAL_CHANNELS(8(0x8))

가상 채널을 사용할 수 있는 권한입니다.

[in] nLength

pSecurityDescriptor 매개 변수에서 참조하는 SECURITY_DESCRIPTOR 구조체의 크기(바이트)입니다.

[out] lpnLengthNeeded

전체 보안 설명자를 저장하는 데 필요한 바이트 수를 수신하는 변수에 대한 포인터입니다. 이 숫자가 nLength 매개 변수 값보다 작거나 같으면 보안 설명자가 pSecurityDescriptor 매개 변수에서 참조하는 SECURITY_DESCRIPTOR 구조에 복사됩니다. 그렇지 않으면 아무 작업도 수행되지 않습니다.

반환 값

함수가 성공하면 반환 값은 0이 아닌 값입니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError 함수를 호출합니다.

설명

SECURITY_DESCRIPTOR 구조를 수신하는 버퍼에 필요한 바이트 수를 알 수 없는 경우 nLength를 0으로 설정하여 이 메서드를 호출할 수 있습니다. 그런 다음, 메서드는 lpnLengthNeeded 매개 변수에서 버퍼에 필요한 바이트 수를 반환합니다. 이 숫자에 따라 버퍼를 할당한 다음 메서드를 다시 호출하여 pSecurityDescriptor 를 새로 할당된 버퍼로 설정하고 nLength 를 첫 번째 호출에서 반환된 번호로 설정합니다.

참고

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7
지원되는 최소 서버 Windows Server 2008 R2
대상 플랫폼 Windows
헤더 wtsapi32.h
라이브러리 Wtsapi32.lib
DLL Wtsapi32.dll

추가 정보

SECURITY_DESCRIPTOR

SECURITY_INFORMATION