Condividi tramite


Metodo IWSDiscoveryPublisher::UnPublish (wsddisco.h)

Annuncia la partenza di un host di rete inviando un messaggio Bye .

Sintassi

HRESULT UnPublish(
  [in]           LPCWSTR              pszId,
  [in]           ULONGLONG            ullInstanceId,
  [in]           ULONGLONG            ullMessageNumber,
  [in, optional] LPCWSTR              pszSessionId,
  [in, optional] const WSDXML_ELEMENT *pAny
);

Parametri

[in] pszId

Indirizzo logico o fisico del dispositivo, usato come indirizzo dell'endpoint del dispositivo. Un indirizzo logico è nel formato urn:uuid:{guid}. Un indirizzo fisico può essere un URI preceduto da http o https o semplicemente un URI preceduto da uri. Quando possibile, usare un indirizzo logico.

[in] ullInstanceId

Identificatore per l'istanza corrente del dispositivo da pubblicare. Questo identificatore deve essere incrementato ogni volta che il servizio viene riavviato. Per altre informazioni sugli identificatori di istanza, vedere Appendice I della specifica WS-Discovery.

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

[in] ullMessageNumber

Contatore nell'ambito dell'identificatore di istanza per il messaggio corrente. Il numero di messaggio deve essere incrementato per ogni messaggio.

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

[in, optional] pszSessionId

Identificatore univoco nell'ambito dell'identificatore di istanza per la sessione corrente. Questo parametro corrisponde all'identificatore di sequenza nel blocco AppSequence nel messaggio Probe. Per altre informazioni sugli identificatori di sequenza, vedere Appendice I della specifica WS-Discovery.

Questo parametro può essere NULL.

[in, optional] pAny

Puntatore a una struttura WSDXML_ELEMENT che contiene un elemento XML da inserire nella sezione "ANY" del corpo del messaggio.

Valore restituito

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

Codice restituito Descrizione
S_OK
Metodo completato correttamente.
E_INVALIDARG
Una o più delle condizioni seguenti sono vere:
  • pszId è NULL.
  • La lunghezza di pszId supera WSD_MAX_TEXT_LENGTH (8192).
  • La lunghezza di pszSessionId supera WSD_MAX_TEXT_LENGTH (8192).
E_ABORT
L'autore non è stato avviato. Il collegamento di un sink di notifica avvia il server di pubblicazione. Per collegare un sink, chiamare RegisterNotificationSink.
E_OUTOFMEMORY
Memoria insufficiente per completare l'operazione.

Commenti

In caso di esito positivo, UnPublish invierà un messaggio di WS-Discovery Bye alla subnet locale con le informazioni fornite.

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

IWSDiscoveryPublisher