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 |