Metodo IWSDiscoveryProvider::SearchByAddress (wsddisco.h)

Articolo
03/04/2024

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

Condividi tramite