Condividi tramite


enumerazione WS_TRANSFER_MODE (webservices.h)

Indica se i messaggi inviati o ricevuti vengono trasmessi o memorizzati nel buffer.

Sintassi

typedef enum {
  WS_STREAMED_INPUT_TRANSFER_MODE = 0x1,
  WS_STREAMED_OUTPUT_TRANSFER_MODE = 0x2,
  WS_BUFFERED_TRANSFER_MODE = 0x0,
  WS_STREAMED_TRANSFER_MODE
} WS_TRANSFER_MODE;

Costanti

 
WS_STREAMED_INPUT_TRANSFER_MODE
Valore: 0x1
L'impostazione di questo flag indica che i messaggi vengono recapitati in blocchi. Inizio del messaggio
(tag di apertura, intestazioni e tag corpo di apertura) verrà restituito all'applicazione
al termine di WsReadMessageStart . Spetta all'applicazione chiamare
WsFillBody prima di leggere ogni blocco del corpo del messaggio. La fine di
il messaggio (tag del corpo di chiusura e della busta) verrà letto quando viene chiamato WsReadMessageEnd .


Non impostando questo flag significa che l'intero messaggio viene letto e memorizzato nel buffer
in memoria prima di WsReadMessageStart indica il completamento.
WS_STREAMED_OUTPUT_TRANSFER_MODE
Valore: 0x2
L'impostazione di questo flag indica che i messaggi vengono trasmessi in blocchi. Inizio del messaggio (apertura)
il tag envelope, le intestazioni e il tag corpo di apertura) verranno trasmessi quando viene chiamato WsWriteMessageStart . Spetta all'applicazione chiamare WsFlushBody dopo aver scritto ogni blocco
del corpo del messaggio per fare in modo che il blocco venga trasmesso.
Tutti i dati rimanenti del corpo verranno trasmessi quando viene chiamato WsWriteMessageEnd , insieme a
fine del messaggio (tag del corpo di chiusura e busta).


Non impostando questo flag significa che l'intero messaggio viene memorizzato nel buffer in
memoria e viene trasmessa solo dopo la chiamata a WsWriteMessageEnd .
WS_BUFFERED_TRANSFER_MODE
Valore: 0x0
I messaggi scritti o letti vengono memorizzati nel buffer.


Equivale a specificare nessuno dei due
WS_STREAMED_INPUT_TRANSFER_MODE
WS_STREAMED_OUTPUT_TRANSFER_MODE.
WS_STREAMED_TRANSFER_MODE
I messaggi scritti o letti vengono trasmessi.


Equivale a specificare entrambi
WS_STREAMED_INPUT_TRANSFER_MODE e
WS_STREAMED_OUTPUT_TRANSFER_MODE.

Commenti

Questo valore viene specificato per un canale usando la proprietà del canale WS_CHANNEL_PROPERTY_TRANSFER_MODE .

Il modello di programmazione di streaming può essere usato indipendentemente dalla modalità di trasferimento usata. Nel caso in cui lo streaming non venga usato, le chiamate alle chiamate a WsFillBody e WsFlushBody sono NOP.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Intestazione webservices.h