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

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

구문

HRESULT SearchByAddress(
  [in]           LPCWSTR pszAddress,
  [in, optional] LPCWSTR pszTag
);

매개 변수

[in] pszAddress

디바이스의 HTTP 전송 주소입니다.

[in, optional] pszTag

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

반환 값

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

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

설명

SearchByAddress 는 알려진 URL에서 디바이스를 식별하기 위해 HTTP를 통해 WS-Discovery 프로브 를 시작합니다. 프로브는 pszAddress로 지정된 주소로 전송됩니다. 이 호출로 인해 하나 이상의 콜백 추가 가 발생할 수 있습니다. 검색이 완료되기 전에 콜백 추가 가 실행되면 SearchComplete 콜백이 발급됩니다. 그렇지 않으면 SearchFailed 콜백이 발급됩니다. 검색을 시작하고 이러한 알림 중 하나를 받는 간격은 최대 30초입니다.

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

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

요구 사항

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

추가 정보

IWSDiscoveryProvider