Messaggio (servizi Web Windows)
Un messaggio è un oggetto che incapsula i dati trasmessi o ricevuti. La struttura di un messaggio è definita da SOAP e include un set di intestazioni e un corpo. Le intestazioni vengono sempre memorizzate nel buffer in memoria, ma il corpo viene letto e scritto con un'API di streaming.
I messaggi hanno un set di proprietà che possono essere usate per specificare impostazioni facoltative che controllano il comportamento di un messaggio e per fornire un modo per recuperare informazioni aggiuntive sui messaggi ricevuti,ad esempio le informazioni di sicurezza. Per un elenco completo delle proprietà dei messaggi, vedere WS_MESSAGE_PROPERTY_ID .
Un messaggio viene indirizzato a un indirizzo endpoint specifico.
Un WS_FAULT è un tipo speciale di contenuto del messaggio usato per rappresentare gli errori restituiti da un endpoint remoto.
I messaggi vengono sottoposti a codifica che trasforma il codice XML in un formato di collegamento lineare prima di essere trasmessi.
Per altre informazioni sui messaggi, vedere l'argomento Channel Layer Overview .For more information on messages, see the Channel Layer Overview topic.
Gli esempi seguenti illustrano l'uso dei messaggi in WWSAPI.
Esempio | Descrizione |
---|---|
CustomHeaderExample | Illustra l'uso di intestazioni di messaggio personalizzate. |
MessageEncodingExample | Illustra la codifica e la decodifica di un messaggio. |
ForwardMessageExample | Illustra l'inoltro di un messaggio. |
Gli elementi API seguenti vengono usati con i messaggi.
Richiamata | Descrizione |
---|---|
WS_MESSAGE_DONE_CALLBACK | Notifica al chiamante che il messaggio ha completato l'uso della struttura WS_XML_READER fornita alla funzione WsReadEnvelopeStart o della struttura WS_XML_WRITER fornita alla funzione WsWriteEnvelopeStart. |
Enumerazione | Descrizione |
---|---|
WS_ADDRESSING_VERSION | Versione della specifica utilizzata per le intestazioni di indirizzamento. |
WS_ENVELOPE_VERSION | Versione della specifica utilizzata per la struttura envelope. |
WS_HEADER_ATTRIBUTES | Set di flag che rappresentano gli attributi mustUnderstand SOAP e di inoltro di un'intestazione. |
WS_HEADER_TYPE | Tipo dell'intestazione. |
WS_MESSAGE_INITIALIZATION | Specifica le intestazioni da aggiungere a WsInitializeMessage. |
WS_MESSAGE_PROPERTY_ID | ID di ogni proprietà del messaggio. |
WS_MESSAGE_STATE | Stato del messaggio. |
Funzione | Descrizione |
---|---|
WsAddressMessage | Assegna un indirizzo di destinazione a un messaggio. |
WsCheckMustUnderstandHeaders | Verifica che le intestazioni specificate siano state comprese in modo appropriato dal ricevitore. |
WsCreateMessage | Crea un'istanza di un oggetto WS_MESSAGE . |
WsCreateMessageForChannel | Crea un messaggio appropriato per l'uso con un canale specifico. |
WsFillBody | Assicura che sia disponibile un numero sufficiente di byte in un messaggio per la lettura. |
WsFlushBody | Scarica tutti i dati del corpo dei messaggi accumulati scritti. |
WsFreeMessage | Rilascia la risorsa di memoria associata a un messaggio. |
WsGetCustomHeader | Trova l'intestazione definita dall'applicazione del messaggio e la deserializza. |
WsGetHeader | Trova una particolare intestazione standard nel messaggio e la deserializza. |
WsGetHeaderAttributes | Popola un parametro ULONG con il WS_HEADER_ATTRIBUTES dall'elemento di intestazione in cui è posizionato il lettore. |
WsGetMessageProperty | Recupera una proprietà dell'oggetto Message specificata. |
WsInitializeMessage | Inizializza le intestazioni per il messaggio in preparazione per l'elaborazione. |
WsMarkHeaderAsUnderstood | Contrassegna un'intestazione come compresa dall'applicazione. |
WsReadBody | Deserializza un valore dal lettore XML del messaggio. |
WsReadEnvelopeEnd | Legge gli elementi di chiusura di un messaggio. |
WsReadEnvelopeStart | Legge le intestazioni del messaggio e prepara a leggere gli elementi del corpo. |
WsRemoveCustomHeader | Rimuove un'intestazione personalizzata dal messaggio. |
WsRemoveHeader | Rimuove l'oggetto WS_HEADER_TYPE standard da un messaggio. |
WsResetMessage | Imposta di nuovo lo stato del messaggio su WS_MESSAGE_STATE_EMPTY. |
WsSetHeader | Aggiunge o sostituisce l'intestazione standard specificata nel messaggio. |
WsWriteBody | Scrive un valore nel corpo di un messaggio. |
WsWriteEnvelopeEnd | Scrive gli elementi di chiusura di un messaggio. |
WsWriteEnvelopeStart | Scrive l'inizio del messaggio, incluso il set corrente di intestazioni del messaggio e prepara a scrivere gli elementi del corpo. |
Handle | Descrizione |
---|---|
WS_MESSAGE | Tipo opaco utilizzato per fare riferimento a un oggetto messaggio. |
Struttura | Descrizione |
---|---|
WS_FAULT | Valore di errore trasportato nel corpo di un messaggio che indica un errore di elaborazione. |
WS_FAULT_CODE | Rappresenta un codice di errore. |
WS_FAULT_REASON | Contiene una spiegazione dell'errore. |
WS_MESSAGE_PROPERTIES | Specifica un set di strutture WS_MESSAGE_PROPERTY. |
WS_MESSAGE_PROPERTY | Specifica un'impostazione specifica del messaggio. |