enumerazione WS_TRANSFER_MODE (webservices.h)

Articolo
03/03/2024

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 né 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

Condividi tramite