다음을 통해 공유

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

  • 아티클

디바이스 식별자를 통해 WS-Discovery 호스트에 대한 검색을 초기화합니다.

구문

HRESULT SearchById(
  [in]           LPCWSTR pszId,
  [in, optional] LPCWSTR pszTag
);

매개 변수

[in] pszId

원하는 검색 공급자의 디바이스 식별자입니다.

[in, optional] pszTag

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

반환 값

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

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

설명

SearchById 는 이전에 알려진 특정 디바이스를 찾기 위해 WS-Discovery 해결 을 시작합니다. pszId 는 Resolve에서 엔드포인트 주소로 사용됩니다. 이 호출로 인해 하나 이상의 콜백 추가 가 발생할 수 있습니다. 검색이 완료되기 전에 추가 콜백이 실행되면 SearchComplete 콜백이 실행됩니다. 그렇지 않으면 SearchFailed 콜백이 발급됩니다.

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

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

요구 사항

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

참고 항목

IWSDiscoveryProvider