IOpenSearchSource::GetResults 메서드(shobjidl_core.h)

아티클
08/26/2023

RSS 또는 Atom 형식으로 서식이 지정된 OpenSearch 데이터 원본에서 검색 결과를 반환합니다.

구문

HRESULT GetResults(
  [in]  HWND    hwnd,
  [in]  LPCWSTR pszQuery,
  [in]  DWORD   dwStartIndex,
  [in]  DWORD   dwCount,
  [in]  REFIID  riid,
  [out] void    **ppv
);

매개 변수

[in] hwnd

형식: HWND

호출자의 창 핸들입니다.

[in] pszQuery

형식: LPCWSTR

사용자가 입력한 쿼리입니다. 이 매개 변수는 OpenSearch {searchTerms} 매개 변수와 동일하며 비어 있을 수 있습니다.

[in] dwStartIndex

형식:DWORD

요청되는 첫 번째 결과의 인덱스입니다. OpenSearch {startIndex} 매개 변수와 동일합니다. 아래의 설명을 참조하세요.

[in] dwCount

형식:DWORD

요청되는 결과 수입니다. OpenSearch {count} 매개 변수와 동일합니다.

[in] riid

형식: REFIID

요청되는 인터페이스의 IID입니다. 일반적으로 IID_IStream.

[out] ppv

형식: void**

RIID에서 지정한 형식의 인터페이스 포인터로, 결과를 Atom 또는 RSS 형식으로 포함하는 개체에 대한 포인터입니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 오류 값을 반환합니다. B_S_ENDOFROWSET 필요에 따라 결과의 끝을 의미합니다. 다음 오류는 정보 표시줄에 적절한 오류 메시지를 표시합니다.

INET_E_AUTHENTICATION_REQUIRED(사용자에게 이 리소스에 액세스할 수 있는 권한이 없음)
INET_E_RESOURCE_NOT_FOUND(위치를 사용할 수 없음)
INET_E_DOWNLOAD_FAILURE(서버 오류)

설명

Windows Explorer 검색 쿼리 매개 변수를 사용하여 이 메서드를 호출합니다. IOpenSearchSource 구현은 사용자 지정 인증 UI를 제공하거나 독점 API를 사용하여 데이터 원본에 연결하는 등 필요한 작업을 수행한 후 일부 또는 모든 결과를 반환합니다.

페이징된 결과

웹 서비스가 요청당 제한된 수의 결과를 반환하지 않으려면 이 메서드는 한 번에 결과의 "페이지"만 반환할 수 있습니다. Windows Explorer 이 메서드를 반복적으로 호출하고 새 인덱스 번호를 지정하여 결과의 추가 페이지를 가져올 수 있습니다. 결과를 반환할 때 첫 번째 결과는 dwStartIndex에서 요청한 인덱스의 결과여야 합니다.

인덱스 번호 및 개수

인덱스 번호는 결과 페이지에서 첫 번째 결과를 식별합니다. OpenSearch {startIndex} 매개 변수와 동일합니다. OpenSearch {count} 매개 변수와 동일한 개수는 페이지당 반환되는 예상 또는 기본 설정 항목 수를 식별합니다.

웹 서비스가 결과의 첫 페이지에 20개 항목을 반환하는 경우 예상 페이지 크기는 20입니다. 다음 20개 항목을 가져오기 위해 Windows Explorer dwStartIndex의 경우 값이 21이고 dwCount의 경우 값이 20인 IOpenSearchSource::GetResults를 호출합니다. 웹 서비스에서 반환된 결과 페이지에 예상된 페이지 크기보다 적은 항목이 있는 경우 Windows Explorer 결과의 마지막 페이지를 수신했다고 가정하고 요청을 중지합니다.

요구 사항


지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)

추가 정보

IOpenSearchSource

다음을 통해 공유