Metodo IWSDiscoveryProvider::SearchByType (wsddisco.h)

Articolo
03/04/2024

Inizializza una ricerca di host WS-Discovery in base al tipo di dispositivo.

Sintassi

HRESULT SearchByType(
  [in, optional] const WSD_NAME_LIST *pTypesList,
  [in, optional] const WSD_URI_LIST  *pScopesList,
  [in, optional] LPCWSTR             pszMatchBy,
  [in, optional] LPCWSTR             pszTag
);

Parametri

[in, optional] pTypesList

Puntatore a una struttura WSD_NAME_LIST che rappresenta l'elenco dei tipi di provider di individuazione da cercare. Può essere NULL.

[in, optional] pScopesList

Puntatore a una struttura WSD_URI_LIST che rappresenta l'elenco di ambiti del provider di individuazione da cercare. Può essere NULL.

[in, optional] pszMatchBy

Regola di corrispondenza usata per gli ambiti. Può essere NULL.

[in, optional] pszTag

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

Valore restituito

I valori restituiti possibili includono, ma non sono limitati ai seguenti:

Codice restituito	Descrizione
S_OK	Il metodo è stato completato correttamente.
E_INVALIDARG	La lunghezza in caratteri di pszMatchBy 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 collegata. È necessario chiamare Attach prima di chiamare questo metodo.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.

Commenti

SearchByType avvia un probe WS-Discovery nel tentativo di individuare gli host di individuazione corrispondenti ai criteri specificati. Questo metodo consente la corrispondenza in base a tipi, ambiti, alcune combinazioni dei due dispositivi o corrispondenti a tutti i dispositivi con supporto per l'individuazione (quando non vengono forniti ambiti o tipi).

pszMatchBy deve essere fornito se e solo se è disponibile anche pScopesList . Questa chiamata può comportare uno o più callback add . Se vengono rilasciati callback add prima del completamento della ricerca, verrà emesso un callback SearchComplete ; in caso contrario, verrà generato 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

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