OPENQUERYWINDOW 구조체(cmnquery.h)

OPENQUERYWINDOW 구조체는 ICommonQuery::OpenQueryWindow 메서드와 함께 사용하여 디렉터리 서비스 쿼리 대화 상자를 초기화합니다.

구문

typedef struct {
  DWORD         cbStruct;
  DWORD         dwFlags;
  CLSID         clsidHandler;
  LPVOID        pHandlerParameters;
  CLSID         clsidDefaultForm;
  IPersistQuery *pPersistQuery;
  union {
    void         *pFormParameters;
    IPropertyBag *ppbFormParameters;
  };
} OPENQUERYWINDOW, *LPOPENQUERYWINDOW;

멤버

cbStruct

구조체의 크기(바이트)를 포함합니다. 이 멤버는 버전 관리 및 매개 변수 유효성 검사에 사용되며 ICommonQuery::OpenQueryWindow를 호출하기 전에 채워야 합니다.

dwFlags

디렉터리 서비스 쿼리 대화 상자의 동작을 정의하는 플래그 집합을 포함합니다. 이 값은 0이거나 다음 목록에 나열된 값 중 하나 이상의 조합일 수 있습니다.

OQWF_DEFAULTFORM

쿼리 대화 상자가 초기화 시 clsidDefaultForm 멤버가 지정한 양식을 선택하도록 합니다.

OQWF_HIDEMENUS

대화 상자가 메뉴 모음을 숨기도록 합니다.

OQWF_HIDESEARCHUI

표준 검색 사용자 인터페이스 없이 쿼리 대화 상자를 만들도록 합니다. 여기에는 지금 찾기, 중지 및 지우기 모든 푸시버튼이 포함됩니다.

OQWF_ISSUEONOPEN

쿼리 대화 상자가 처음 표시될 때 쿼리가 실행되도록 합니다.

OQWF_LOADQUERY

쿼리 대화 상자가 pPersistQuery 멤버의 IPersistQuery 인터페이스에서 쿼리를 검색하도록 합니다.

OQWF_OKCANCEL

해당하는 경우 쿼리 대화 상자에 확인 및 취소 단추가 표시되도록 합니다. 대화 상자에 실제로 표시되는 단추는 사용된 양식 및 기타 지정된 플래그에 따라 달라집니다.

OQWF_PARAMISPROPERTYBAG

ppbFormParameters 멤버에 IPropertyBag 인터페이스가 포함되어 있음을 나타냅니다.

OQWF_REMOVEFORMS

찾기: 레이블이 나타내는 양식 선택기 레이블 및 드롭다운 목록 없이 쿼리 대화 상자를 만들도록 합니다.

OQWF_REMOVESCOPES

쿼리 대화 상자가 in: 레이블로 표시되는 scope 레이블 및 드롭다운 목록 없이 만들어지도록 합니다.

OQWF_SAVEQUERYONOK

쿼리 대화 상자를 닫으면 pPersistQuery 멤버의 IPersistQuery 인터페이스에 쿼리를 저장합니다.

OQWF_SHOWOPTIONAL

쿼리 대화 상자가 양식 드롭다운 목록에 선택적 양식을 표시하도록 합니다. 선택적 양식은 CQFORM 구조체의 dwFlags 멤버에서 CQFF_ISOPTIONAL 플래그를 지정하는 양식입니다.

OQWF_SINGLESELECT

쿼리 대화 상자에서 쿼리 결과 목록을 단일 선택 항목으로 만듭니다.

clsidHandler

쿼리 대화 상자에서 사용할 쿼리 처리기를 지정하는 CLSID 값을 포함합니다. 이 멤버의 값은 pHandlerParameters 멤버가 가리키는 구조체의 형식도 결정합니다.

CLSID_DsQuery

이 쿼리는 표준 디렉터리 서비스 쿼리이며 현재 지원되는 유일한 쿼리입니다.

pHandlerParameters

쿼리 처리기의 데이터를 포함하는 구조체에 대한 포인터입니다. 이 멤버가 가리키는 구조체의 형식은 clsidHandler 멤버에 의해 정의됩니다. 다음 목록에서는 clsidHandler 멤버의 값을 기반으로 가능한 구조체 형식을 나열합니다.

CLSID_DsQuery

DSQUERYINITPARAMS 구조체에 대한 포인터를 포함합니다.

clsidDefaultForm

쿼리 대화 상자에 표시할 기본 양식을 지정합니다. dwFlags에 OQWF_DEFAULTFORM 포함되지 않은 경우 이 멤버는 무시됩니다. 이 멤버는 사용자 지정 쿼리 양식의 CLSID 또는 시스템에서 제공하는 양식 중 하나를 포함할 수 있습니다.

CLSID_DsFindAdvanced

사용자 지정 검색 쿼리 양식을 식별합니다.

CLSID_DsFindComputer

컴퓨터 쿼리 양식을 식별합니다.

CLSID_DsFindContainer

조직 단위 쿼리 양식을 식별합니다.

CLSID_DsFindDomainController

도메인 컨트롤러 쿼리 양식을 식별합니다.

CLSID_DsFindFrsMembers

FRS 멤버 쿼리 양식을 식별합니다.

CLSID_DsFindObjects

예약되어 있습니다.

CLSID_DsFindPeople

사용자, 연락처 및 그룹 쿼리 양식을 식별합니다.

CLSID_DsFindPrinter

프린터 쿼리 양식을 식별합니다 .

CLSID_DsFindVolume

공유 폴더 쿼리 양식을 식별합니다.

CLSID_DsFindWriteableDomainController

도메인 컨트롤러 쿼리 양식을 식별하고 쓰기 가능한 도메인 컨트롤러를 표시합니다.

pPersistQuery

쿼리 데이터를 저장하고 검색하는 데 사용되는 IPersistQuery 인터페이스에 대한 포인터입니다. 이 데이터는 쿼리 결과가 아니라 쿼리 자체와 관련이 있습니다. dwFlags에OQWF_LOADQUERY 포함된 경우 이 인터페이스에서 쿼리 데이터를 가져옵니다. dwFlags에OQWF_SAVEQUERY 포함된 경우 쿼리 데이터가 이 인터페이스에 저장됩니다.

pFormParameters

예약되어 있습니다. 양식에 대한 매개 변수 초기화 데이터를 제공하는 구조체 또는 인터페이스에 대한 포인터입니다. 이 포인터의 내용은 clsidDefaultForm 멤버가 지정한 양식 클래스에 의해 정의됩니다.

ppbFormParameters

양식에 대한 매개 변수 초기화 데이터를 제공하는 IPropertyBag 인터페이스에 대한 포인터입니다. 이 속성 모음의 내용은 clsidDefaultForm 멤버에 의해 지정된 양식 클래스에 의해 정의됩니다. 다음 시스템에서 제공하는 양식은 이 멤버를 지원합니다.

CLSID_DsFindPrinter

이 양식은 속성 모음에서 다음 속성을 가져옵니다.

속성 이름	Description
printName	초기 프린터 이름을 포함합니다.
printLocation	초기 프린터 위치를 포함합니다.
printModel	프린터의 초기 모델 이름 및/또는 번호를 포함합니다.

 

CLSID_DsFindComputer

이 양식을 사용하여 컴퓨터 역할을 지정합니다. 속성 모음에는 computerRole이 포함되어야 합니다. 다음 값의 조합을 사용하여 포함되는 역할을 제한합니다.

값	역할
0x0000	모든 역할
0x0001	워크스테이션 또는 서버
0x0002	모든 도메인 컨트롤러
0x0004	쓰기 가능한 도메인 컨트롤러
0x0008	Read-only Domain Controllers

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
머리글	cmnquery.h

추가 정보

CQFORM

DSQUERYINITPARAMS

Active Directory Domain Services 구조체 표시

ICommonQuery::OpenQueryWindow

IPersistQuery