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.
[in] ullMessageNumber
Contatore nell'ambito dell'identificatore di istanza per il messaggio corrente. Il numero di messaggio deve essere incrementato per ogni messaggio.
[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 |
---|---|
|
Metodo completato correttamente. |
|
Una o più delle condizioni seguenti sono vere:
|
|
L'autore non è stato avviato. Il collegamento di un sink di notifica avvia il server di pubblicazione. Per collegare un sink, chiamare RegisterNotificationSink. |
|
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 |