Compartilhar via


enumeração WS_TRANSFER_MODE (webservices.h)

Se as mensagens enviadas ou recebidas são transmitidas ou armazenadas em buffer.

Syntax

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;

Constantes

 
WS_STREAMED_INPUT_TRANSFER_MODE
Valor: 0x1
Definir esse sinalizador significa que as mensagens são entregues em partes. O início da mensagem
(marca de abertura, cabeçalhos e marca de corpo de abertura) serão retornados ao aplicativo
quando WsReadMessageStart for concluído. Cabe ao aplicativo chamar
WsFillBody antes de ler cada parte do corpo da mensagem. O fim do
a mensagem (marcas de corpo de fechamento e envelope) será lida quando WsReadMessageEnd for chamado.


Não definir esse sinalizador significa que toda a mensagem é lida e armazenada em buffer
na memória antes que WsReadMessageStart indique a conclusão.
WS_STREAMED_OUTPUT_TRANSFER_MODE
Valor: 0x2
Definir esse sinalizador significa que as mensagens são transmitidas em partes. O início da mensagem (abrindo
marca envelope, cabeçalhos e marca de corpo de abertura) serão transmitidos quando WsWriteMessageStart for chamado. Cabe ao aplicativo chamar WsFlushBody depois de gravar cada parte
do corpo da mensagem para fazer com que a parte seja transmitida.
Todos os dados restantes do corpo serão transmitidos quando WsWriteMessageEnd for chamado, juntamente com
o final da mensagem (fechando marcas de corpo e envelope).


Não definir esse sinalizador significa que toda a mensagem está armazenada em buffer em
memory e só é transmitido quando WsWriteMessageEnd é chamado.
WS_BUFFERED_TRANSFER_MODE
Valor: 0x0
As mensagens gravadas ou lidas são armazenadas em buffer.


Isso é equivalente a especificar nenhum dos dois
WS_STREAMED_INPUT_TRANSFER_MODE nem
WS_STREAMED_OUTPUT_TRANSFER_MODE.
WS_STREAMED_TRANSFER_MODE
As mensagens gravadas ou lidas são transmitidas.


Isso é equivalente a especificar ambos
WS_STREAMED_INPUT_TRANSFER_MODE e
WS_STREAMED_OUTPUT_TRANSFER_MODE.

Comentários

Esse valor é especificado para um canal usando a propriedade WS_CHANNEL_PROPERTY_TRANSFER_MODE canal.

O modelo de programação de streaming pode ser usado independentemente do modo de transferência usado. No caso em que o streaming não é usado, as chamadas para as chamadas para WsFillBody e WsFlushBody são NOPs.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho webservices.h