Metodo IWSDiscoveryProvider::SearchById (wsddisco.h)

Articolo
08/28/2023

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

Sintassi

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

Parametri

[in] pszId

Identificatore del dispositivo del provider di individuazione desiderato.

[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	pszId è NULL, la lunghezza in caratteri di pszId 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

SearchById avvia un WS-Discovery Resolve in un tentativo di individuare un dispositivo specifico noto in precedenza. pszId viene usato come indirizzo dell'endpoint in Resolve. 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 .

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


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