DSQUERYINITPARAMS 구조체(dsquery.h)

아티클
02/29/2024

DSQUERYINITPARAMS 구조체는 디렉터리 서비스 쿼리에서 찾아보기 대화 상자를 초기화하는 데 사용되는 데이터를 설명합니다.

구문

typedef struct {
  DWORD  cbStruct;
  DWORD  dwFlags;
  LPWSTR pDefaultScope;
  LPWSTR pDefaultSaveLocation;
  LPWSTR pUserName;
  LPWSTR pPassword;
  LPWSTR pServer;
} DSQUERYINITPARAMS, *LPDSQUERYINITPARAMS;

멤버

cbStruct

이 구조체의 크기(바이트)를 포함합니다.

dwFlags

쿼리 동작을 정의하는 플래그 집합을 포함합니다. 이 값은 0이거나 다음 값 중 하나 이상의 조합일 수 있습니다.

DSQPF_ENABLEADMINFEATURES

상황에 맞는 메뉴 및 속성 페이지에 대해 관리 표시 지정자와 같은 디렉터리 서비스 관리 도구에서 지원하는 기능을 사용합니다.

DSQPF_ENABLEADVANCEDFEATURES

상황에 맞는 메뉴 및 속성 페이지에 전달되는 IDataObject instance 고급 기능을 지정합니다.

DSQPF_HASCREDENTIALS

이 구조 체의 pUserName, pPassword 및 pServer 멤버는 서버 및 자격 증명 데이터를 지정할 수 있습니다.

DSQPF_NOCHOOSECOLUMNS

쿼리 대화 상자 보기 메뉴에서 열 선택 항목을 사용하지 않도록 설정합니다.

DSQPF_NOSAVE

쿼리 대화 상자 파일 메뉴에서 검색 저장 항목을 제거합니다.

DSQPF_SAVELOCATION

pDefaultSaveLocation 멤버에는 검색이 저장될 기본 파일 시스템 경로가 포함되어 있습니다.

DSQPF_SHOWHIDDENOBJECTS

쿼리 대화 상자가 쿼리 결과 목록에 숨겨진 개체를 표시하도록 합니다.

pDefaultScope

검색에 대한 기본 scope ADsPath를 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 기본 검색 scope 지정되지 않은 경우 이 멤버를 NULL로 설정합니다.

pDefaultSaveLocation

검색이 저장될 기본 파일 시스템 경로를 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. dwFlags 멤버에 DSQPF_SAVELOCATION 포함되어 있지 않으면 이 멤버는 무시됩니다.

pUserName

유효한 도메인 표기법의 사용자 이름(예: "fabrikam\jeffsmith")이 포함된 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

pPassword

pUserName 멤버가 지정한 사용자의 암호를 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

pServer

신뢰할 수 있는 도메인 목록을 읽는 서버의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 목록은 대화 상자 에서 In: 드롭다운 목록을 채우는 데 사용됩니다.

설명

이 구조는 CLSID_DsQuery 쿼리 처리기와 관련이 있습니다. 이 구조체는 OPENQUERYWINDOW 구조체의 clsidHandler 멤버에 대해 CLSID_DsQuery 설정된 경우 OPENQUERYWINDOW 구조체의 pHandlerParameters 멤버에 사용됩니다. 자세한 내용 및 이 API를 사용하기 위한 코드 예제 및 기타 관련 API는 ICommonQuery::OpenQueryWindow를 참조하세요.