다음을 통해 공유

IWRdsProtocolConnection::QueryProperty 메서드(wtsprotocol.h)

  • 아티클

프로토콜에서 속성 값을 검색합니다. 이 메서드는 다른 Windows 모듈에서 데이터를 요청하거나 프로토콜로 데이터를 보내는 데 사용할 수 있습니다.

구문

HRESULT QueryProperty(
  [in]            GUID                 QueryType,
  [in]            ULONG                ulNumEntriesIn,
  [in]            ULONG                ulNumEntriesOut,
  [in, optional]  PWRDS_PROPERTY_VALUE pPropertyEntriesIn,
  [out, optional] PWRDS_PROPERTY_VALUE pPropertyEntriesOut
);

매개 변수

[in] QueryType

요청된 속성을 지정하는 GUID 입니다. 다음 값 중 하나일 수 있습니다.

WRDS_QUERY_ALLOWED_INITIAL_APP(C77D1B30-5BE1-4c6b-A0E1-BD6D2E5C9FCC)

초기 애플리케이션의 실행을 허용해야 하는지 여부를 결정하기 위해 원격 데스크톱 서비스 서비스에서 보냅니다.

입력할 때 원격 데스크톱 서비스 서비스는 pPropertyEntriesIn 매개 변수의 세 가지 WRDS_PROPERTY_VALUE 구조를 전달합니다.

입력 구조 1:

  • pPropertyEntriesIn[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[0].u.strVal.pstrVal = 애플리케이션 이름
  • pPropertyEntriesIn[0].u.strVal.size = 이름 문자열의 길이
입력 구조 2:
  • pPropertyEntriesIn[1].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[1].u.strVal.pstrVal = 애플리케이션 매개 변수
  • pPropertyEntriesIn[1].u.strVal.size = 매개 변수 문자열의 길이
입력 구조 3:
  • pPropertyEntriesIn[2].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesIn[2].u.ulVal = 예약
출력에서 pPropertyEntriesOut 매개 변수에 다음 세 개의 WRDS_PROPERTY_VALUE 구조를 전달합니다. 원격 데스크톱 서비스 서비스에서 전달된 애플리케이션을 사용하려면 입력 구조 1과 2를 출력 구조체 1과 2에 복사합니다.

출력 구조 1:

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[0].u.strVal.pstrVal = 디렉터리를 포함한 명령줄
  • pPropertyEntriesOut[0].u.strVal.size = 명령줄의 길이
출력 구조 2:
  • pPropertyEntriesOut[1].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[1].u.strVal.pstrVal = 애플리케이션 매개 변수
  • pPropertyEntriesOut[1].u.strVal.size = 매개 변수 문자열의 길이
출력 구조 3:
  • pPropertyEntriesOut[2].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[2].u.ulVal = 애플리케이션을 실행하려면 0이 아닌 값, 중지할 값은 0입니다.

WRDS_QUERY_LOGON_SCREEN_SIZE (8b8e0fe7-0804-4a0e-b279-8660b1df0049)

WinLogon에서 로그온 화면의 크기를 결정하는 데 사용됩니다.

pPropertyEntriesIn 매개 변수는 NULL입니다.

pPropertyEntriesOut 매개 변수를 다음으로 설정합니다.

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 화면 크기
기본 화면 크기를 사용하지 않으려면 프로토콜이 E_NOTIMPL 반환해야 합니다.

WRDS_QUERY_AUDIOENUM_DLL(9bf4fa97-c883-4c2a-80ab-5a39c9af00db)

원격 데스크톱 서비스 서비스에서 원격 오디오 열거자 DLL의 이름을 쿼리하는 데 사용됩니다.

pPropertyEntriesIn 매개 변수는 NULL입니다.

pPropertyEntriesOut 매개 변수를 다음으로 설정합니다.

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesOut[0].u.strVal.pstrVal = DLL 이름
LocalAlloc 함수를 사용하여 pstrVal에 대한 메모리를 할당해야 합니다.

WRDS_QUERY_MF_FORMAT_SUPPORT (41869ad0-6332-4dc8-95d5-db749e2f1d94)

원격 데스크톱 미디어 파운데이션 플러그 인에서 특정 미디어 형식에 사용할 싱크 개체를 결정하는 데 사용됩니다.

입력에서 RCM은 pPropertyEntriesIn 매개 변수에서 다음 WRDS_PROPERTY_VALUE 구조를 전달합니다.

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_BINARY
  • pPropertyEntriesOut[0].u.bVal.pbVal = TSMF_SUPPORT_DATA_IN 구조체
  • pPropertyEntriesOut[0].u.bVal.size = TSMF_SUPPORT_DATA_IN 구조체의 크기
출력에서 pPropertyEntriesOut 매개 변수에 다음 WRDS_PROPERTY_VALUE 구조를 전달합니다.

PROPERTY_DYNAMIC_TIME_ZONE_INFORMATION(cdfd28e-d0b9-4c1f-a5eb-6d1f6c6535b9)

연결에서 동적 표준 시간대 정보를 검색하는 데 사용됩니다.

pPropertyEntriesIn 매개 변수는 NULL입니다.

출력에서 pPropertyEntriesOut 매개 변수에 다음 WRDS_PROPERTY_VALUE 구조를 전달합니다.

커서 깜박임이 비활성화되어야 하는지 여부를 결정하는 데 사용됩니다.

pPropertyEntriesIn 매개 변수는 NULL입니다.

출력에서 pPropertyEntriesOut 매개 변수에 다음 WRDS_PROPERTY_VALUE 구조를 전달합니다.

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 커서 깜박임이 비활성화되면 1, 그렇지 않으면 0

PROPERTY_TYPE_GET_FAST_RECONNECT (6212d757-0043-4862-99c3-9f3059ac2a3b)

원격 데스크톱 서비스 서비스에서 사용할 다시 연결 모드를 결정하는 데 사용됩니다.

pPropertyEntriesIn 매개 변수는 NULL입니다.

출력에서 pPropertyEntriesOut 매개 변수에 다음 WRDS_PROPERTY_VALUE 구조를 전달합니다.

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 빠른 재연결을 사용하지 않도록 설정하려면 0, 기본 빠른 다시 연결의 경우 1, 향상된 빠른 다시 연결의 경우 2

PROPERTY_TYPE_GET_FAST_RECONNECT_USER_SID(197c427a-0135-4b6d-9c5e-e6579a0ab625)

고급 빠른 다시 연결 중에 원격 데스크톱 서비스 서비스에서 다시 연결할 세션이 필터링되는 사용자 SID를 검색하는 데 사용됩니다.

pPropertyEntriesIn 매개 변수는 NULL입니다.

출력에서 pPropertyEntriesOut 매개 변수에 다음 WRDS_PROPERTY_VALUE 구조를 전달합니다.

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_STRING
  • pPropertyEntriesIn[0].u.strVal.pstrVal = 세션 필터로 사용할 사용자 SID
  • pPropertyEntriesIn[0].u.strVal.size = null 종료 문자를 포함한 사용자 SID의 길이
LocalAlloc 함수를 사용하여 pstrVal에 대한 메모리를 할당해야 합니다.

PROPERTY_TYPE_ENABLE_UNIVERSAL_APPS_FOR_CUSTOM_SHELL(ed2c3fda-338d-4d3f-81a3-e767310d908e)

원격 데스크톱 서비스에서 사용하는 ShellAppRuntime.exe 세션 생성 중에 Custom Shell 전에 시작될지 여부를 결정합니다. ShellAppRuntime.exe 사용자 지정 셸에 대한 유니버설 앱 지원을 구현합니다. 기본적으로 사용하도록 설정되지 않습니다(0을 전달하는 것과 동일). 이는 서버 2019 이상 또는 다중 세션 빌드 18950 이상에 Windows 10 Windows 버전에서 사용할 수 있습니다.

pPropertyEntriesIn 매개 변수는 NULL입니다.

출력에서 pPropertyEntriesOut 매개 변수에 다음 WRDS_PROPERTY_VALUE 구조를 전달합니다.

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 0 - 사용자 지정 셸에 유니버설 앱 지원을 사용하도록 설정하지 않음, 1 사용자 지정 셸에 유니버설 앱 지원 사용

CONNECTION_PROPERTY_IDLE_TIME_WARNING (693f7ff5-0c4e-4d17-b8e0-1f70325e5d58)

유휴 타이머가 만료될 때 로그오프 경고 프롬프트가 표시되는지 여부를 확인하는 데 사용됩니다.

pPropertyEntriesIn 매개 변수는 NULL입니다.

출력에서 pPropertyEntriesOut 매개 변수에 다음 WRDS_PROPERTY_VALUE 구조를 전달합니다.

  • pPropertyEntriesOut[0].Type = WRDS_VALUE_TYPE_ULONG
  • pPropertyEntriesOut[0].u.ulVal = 경고 프롬프트를 사용하지 않도록 설정하려면 0, 1을 사용하도록 설정

[in] ulNumEntriesIn

pPropertyEntriesIn 배열의 항목 수입니다.

[in] ulNumEntriesOut

pPropertyEntriesOut 배열의 항목 수입니다.

[in, optional] pPropertyEntriesIn

요청된 속성 정보를 찾는 데 사용할 수 있는 WRDS_PROPERTY_VALUE 구조체에 대한 포인터 배열입니다.

[out, optional] pPropertyEntriesOut

요청된 속성 값을 수신하는 WRDS_PROPERTY_VALUE 구조체에 대한 포인터 배열입니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 성공하지 않으면 HRESULT 오류 코드를 반환합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 지원되는 버전 없음
지원되는 최소 서버 Windows Server 2012
대상 플랫폼 Windows
헤더 wtsprotocol.h(Wtsdefs.h 포함)

추가 정보

IWRdsProtocolConnection