Share via

Metodo IWSDiscoveryProvider::SearchByAddress (wsddisco.h)

  • Articolo

Inizializza una ricerca per gli host WS-Discovery in base all'indirizzo del dispositivo.

Sintassi

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

Parametri

[in] pszAddress

Indirizzo di trasporto HTTP del dispositivo.

[in, optional] pszTag

Tag identificatore facoltativo per questa ricerca. Può essere NULL.

Valore restituito

I valori restituiti possibili includono, ma non sono limitati a, quanto segue:

Codice restituito Descrizione
S_OK
 Metodo completato correttamente.
E_INVALIDARG
 pszAddress è NULL, la lunghezza in caratteri di pszAddress supera WSD_MAX_TEXT_LENGTH (8192) o la lunghezza in caratteri di pszTag supera WSD_MAX_TEXT_LENGTH (8192).
E_ABORT
 Un'interfaccia di callback non è stata associata. È necessario chiamare Attach prima di chiamare questo metodo.
E_OUTOFMEMORY
 Memoria insufficiente per eseguire l'operazione.

Commenti

SearchByAddress avvia un probe WS-Discovery su HTTP in un tentativo di identificare un dispositivo in un URL noto. Il probe viene inviato all'indirizzo specificato da pszAddress. Questa chiamata può comportare uno o più callback aggiuntivi . Se vengono rilasciati callback aggiuntivi prima del completamento della ricerca, verrà rilasciato un callback searchComplete ; in caso contrario, verrà rilasciato un callback searchFailed . L'intervallo tra l'avvio della ricerca e la ricezione di una di queste notifiche può essere massimo di 30 secondi.

pszTag è una stringa facoltativa fornita dall'utente che verrà restituita in entrambi i callback, consentendo al chiamante di associare il callback alla query originale.

Per informazioni sulla risoluzione dei problemi delle applicazioni che chiamano questo metodo, vedere Risoluzione dei problemi delle applicazioni WSDAPI.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wsddisco.h (include Wsdapi.h)
DLL Wsdapi.dll

Vedi anche

IWSDiscoveryProvider