다음을 통해 공유


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

쿼리 대화 상자에 표시할 기본 양식을 지정합니다. dwFlagsOQWF_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