Metodo IWSDDeviceHost::Start (wsdhost.h)

Articolo
03/13/2024

Avvia l'host del dispositivo e pubblica l'host del dispositivo usando un messaggio Hello WS-Discovery. Se a questo metodo viene passato un sink di notifica, viene registrato anche il sink di notifica. Dopo la chiamata di Start , l'host del dispositivo risponderà automaticamente ai messaggi Probe e Resolve.

Sintassi

HRESULT Start(
  [in]           ULONGLONG            ullInstanceId,
  [in]           const WSD_URI_LIST   *pScopeList,
  [in, optional] IWSDDeviceHostNotify *pNotificationSink
);

Parametri

[in] ullInstanceId

L'identificatore dell'istanza. Se non viene specificato alcun identificatore, il valore dell'istanza corrente + 1 viene usato come valore predefinito.

Nota Per la compatibilità con la specifica di WS-Discovery, questo valore deve essere minore o uguale a UINT_MAX (4294967295).

[in] pScopeList

Ambito dell'host del dispositivo. Se NULL, all'host non sono associati ambiti.

[in, optional] pNotificationSink

Riferimento a un oggetto IWSDDeviceHostNotify che specifica il sink di notifica.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il metodo è stato completato correttamente.
S_FALSE	L'host del dispositivo è già stato avviato.
E_FAIL	Il metodo non è riuscito. L'errore potrebbe non riuscire perché l'host non è stato inizializzato. Chiamare Init per inizializzare un host del dispositivo.
E_ABORT	All'host non sono associati metadati.

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	wsdhost.h (include Wsdapi.h)
DLL	Wsdapi.dll

Vedi anche

IWSDDeviceHost

Condividi tramite