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

아티클
08/28/2023

[IWTSProtocolConnection::QueryProperty는 더 이상 Windows Server 2012 사용할 수 없습니다. 대신 IWRdsProtocolConnection::QueryProperty를 사용합니다.]

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

구문

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

매개 변수

[in] QueryType

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

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

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

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

입력 구조 1:

pPropertyEntriesIn[0]. 형식 = WTS_VALUE_TYPE_STRING
pPropertyEntriesIn[0].u.strVal.pstrVal = 애플리케이션 이름
pPropertyEntriesIn[0].u.strVal.size = 이름 문자열의 길이

입력 구조 2:

pPropertyEntriesIn[1]. 형식 = WTS_VALUE_TYPE_STRING
pPropertyEntriesIn[1].u.strVal.pstrVal = 애플리케이션 매개 변수
pPropertyEntriesIn[1].u.strVal.size = 매개 변수 문자열의 길이

입력 구조 3:

pPropertyEntriesIn[2]. 형식 = WTS_VALUE_TYPE_ULONG
pPropertyEntriesIn[2].u.ulVal = reserved

출력에서 pPropertyEntriesOut 매개 변수에 다음 세 개의 WTS_PROPERTY_VALUE 구조를 전달합니다. 원격 데스크톱 서비스 서비스에서 전달된 애플리케이션을 사용하려면 입력 구조 1과 2를 출력 구조체 1과 2에 복사합니다.

출력 구조 1:

pPropertyEntriesOut[0]. 형식 = WTS_VALUE_TYPE_STRING
pPropertyEntriesOut[0].u.strVal.pstrVal = 디렉터리를 포함한 명령줄
pPropertyEntriesOut[0].u.strVal.size = 명령줄의 길이

출력 구조 2:

pPropertyEntriesOut[1]. 형식 = WTS_VALUE_TYPE_STRING
pPropertyEntriesOut[1].u.strVal.pstrVal = 애플리케이션 매개 변수
pPropertyEntriesOut[1].u.strVal.size = 매개 변수 문자열의 길이

출력 구조 3:

pPropertyEntriesOut[2]. 형식 = WTS_VALUE_TYPE_ULONG
pPropertyEntriesOut[2].u.ulVal = 애플리케이션을 실행하려면 0이 아닌 값, 중지할 값은 0입니다.

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

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

pPropertyEntriesIn 매개 변수는 NULL입니다.

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

pPropertyEntriesOut[0]. 형식 = WTS_VALUE_TYPE_ULONG
pPropertyEntriesOut[0].u.ulVal = 화면 크기

기본 화면 크기를 사용하지 않으려면 프로토콜이 E_NOTIMPL 반환해야 합니다.

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

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

pPropertyEntriesIn 매개 변수는 NULL입니다.

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

pPropertyEntriesOut[0]. 형식 = WTS_VALUE_TYPE_STRING
pPropertyEntriesOut[0].u.strVal.pstrVal = DLL 이름

LocalAlloc 함수를 사용하여 pstrVal에 대한 메모리를 할당해야 합니다.

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

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

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

pPropertyEntriesOut[0]. 형식 = WTS_VALUE_TYPE_BINARY
pPropertyEntriesOut[0].u.bVal.pbVal = TSMF_SUPPORT_DATA_IN
pPropertyEntriesOut[0].u.bVal.size = TSMF_SUPPORT_DATA_IN

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

pPropertyEntriesOut[0]. 형식 = WTS_VALUE_TYPE_BINARY
pPropertyEntriesOut[0].u.bVal.pbVal = TSMF_SUPPORT_DATA_OUT
pPropertyEntriesOut[0].u.bVal.size = TSMF_SUPPORT_DATA_OUT

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

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

pPropertyEntriesIn 매개 변수는 NULL입니다.

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

pPropertyEntriesOut[0]. 형식 = WRDS_VALUE_TYPE_BINARY
pPropertyEntriesOut[0].u.bVal.pbVal = WRDS_DYNAMIC_TIME_ZONE_INFORMATION 구조체
pPropertyEntriesOut[0].u.bVal.size = WRDS_DYNAMIC_TIME_ZONE_INFORMATION 구조체의 크기

[in] ulNumEntriesIn

pPropertyEntriesIn 인수에 전달된 WTS_PROPERTY_VALUE 구조체의 수를 포함하는 정수입니다.

[in] ulNumEntriesOut

pPropertyEntriesOut 인수에 전달된 WTS_PROPERTY_VALUE 구조체의 수를 포함하는 정수입니다.

[in, optional] pPropertyEntriesIn

요청된 속성 정보를 찾는 데 사용할 수 있는 하나 이상의 WTS_PROPERTY_VALUE 구조체입니다.

[out, optional] pPropertyEntriesOut

요청된 속성 정보를 포함하는 하나 이상의 WTS_PROPERTY_VALUE 구조체입니다.

반환 값

없음

요구 사항

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