IWSDiscoveryProvider::SearchByType 메서드(wsddisco.h)

디바이스 유형별로 WS-Discovery 호스트에 대한 검색을 초기화합니다.

구문

HRESULT SearchByType(
  [in, optional] const WSD_NAME_LIST *pTypesList,
  [in, optional] const WSD_URI_LIST  *pScopesList,
  [in, optional] LPCWSTR             pszMatchBy,
  [in, optional] LPCWSTR             pszTag
);

매개 변수

[in, optional] pTypesList

검색할 검색 공급자 유형 목록을 나타내는 WSD_NAME_LIST 구조체에 대한 포인터입니다. NULL일 수 있습니다.

[in, optional] pScopesList

검색할 검색 공급자 범위 목록을 나타내는 WSD_URI_LIST 구조체에 대한 포인터입니다. NULL일 수 있습니다.

[in, optional] pszMatchBy

범위에 사용되는 일치 규칙입니다. NULL일 수 있습니다.

[in, optional] pszTag

이 검색에 대한 선택적 식별자 태그입니다. NULL일 수 있습니다.

반환 값

가능한 반환 값에는 다음이 포함되지만 이에 국한되지는 않습니다.

반환 코드	Description
S_OK	메서드가 성공적으로 완료되었습니다.
E_INVALIDARG	pszMatchBy의 문자 길이가 WSD_MAX_TEXT_LENGTH(8192)를 초과하거나 pszTag의 문자 길이가 WSD_MAX_TEXT_LENGTH(8192)를 초과합니다.
E_ABORT	콜백 인터페이스가 연결되지 않았습니다. 이 메서드를 호출하기 전에 Attach 를 호출해야 합니다.
E_OUTOFMEMORY	작업을 수행하기에 충분한 메모리가 없습니다.

설명

SearchByType 은 제공된 조건과 일치하는 검색 호스트를 찾기 위해 WS-Discovery 프로브 를 시작합니다. 이 메서드를 사용하면 형식, 범위, 두 디바이스의 일부 조합 또는 모든 검색 가능 디바이스(범위 또는 형식이 제공되지 않은 경우)를 일치시킬 수 있습니다.

pScopesList도 제공된 경우에만 pszMatchBy를 제공해야 합니다. 이 호출로 인해 하나 이상의 콜백 추가 가 발생할 수 있습니다. 검색이 완료되기 전에 추가 콜백이 실행되면 SearchComplete 콜백이 실행됩니다. 그렇지 않으면 SearchFailed 콜백이 발급됩니다.

pszTag 는 콜백 중 하나에서 다시 공급되는 선택적 사용자 제공 문자열로, 호출자가 콜백을 원래 쿼리와 연결할 수 있도록 합니다.

이 메서드를 호출하는 애플리케이션 문제 해결에 대한 자세한 내용은 WSDAPI 애플리케이션 문제 해결을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	wsddisco.h(Wsdapi.h 포함)
DLL	Wsdapi.dll

추가 정보

IWSDiscoveryProvider