Função WsReadValue (webservices.h)
Lê o texto de um Leitor e o analisa de acordo com o tipo de valor especificado.
O Leitor lê de sua posição atual até o próximo elemento Start ou End e os analisa de acordo com o tipo de valor especificado. Se o Leitor já estiver posicionado em um elemento Start ou End, o buffer permanecerá vazio.
Os comentários são ignorados e o conteúdo cdata é tratado da mesma forma que o conteúdo de outro elemento.
Os espaços em branco à esquerda e à direita são ignorados. Se o valor não puder ser analisado de acordo com o tipo de valor especificado, a função retornará um código de erro WS_E_INVALID_FORMAT . (Consulte Valores retornados dos Serviços Web do Windows.)
Sintaxe
HRESULT WsReadValue(
[in] WS_XML_READER *reader,
[in] WS_VALUE_TYPE valueType,
void *value,
[in] ULONG valueSize,
[in, optional] WS_ERROR *error
);
Parâmetros
[in] reader
Um ponteiro para o Leitor XML do qual o valor é lido.
[in] valueType
O tipo de interpretação de texto.
value
Um ponteiro para os dados analisados se a análise tiver sido bem-sucedida de acordo com o tipo de valor especificado. O tamanho necessário é determinado pelo tipo de valor. Consulte WS_VALUE_TYPE para obter mais informações.
[in] valueSize
O tamanho do byte do valor recuperado.
[in, optional] error
Um ponteiro para um objeto WS_ERROR em que informações adicionais sobre o erro devem ser armazenadas se a função falhar.
Valor retornado
Essa função pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado. |
|
Uma cota foi excedida. |
Comentários
Um exemplo que lê um elemento que contém um valor inteiro.
// Advance the reader to the element
HRESULT hr = WsReadToStartElement(reader, localName, ns, NULL, error);
if (FAILED(hr))
{
return hr;
}
// Advance past the element to the content
hr = WsReadStartElement(reader, error);
if (FAILED(hr))
{
return hr;
}
// Read the content as an integer
__int32 i;
hr = WsReadValue(reader, WS_INT32_VALUE_TYPE, &i, sizeof(i), error);
if (FAILED(hr))
{
return hr;
}
// Read the end element
hr = WsReadEndElement(reader, error);
if (FAILED(hr))
{
return hr;
}
A gramática para os tipos de valores.
WS_BOOL_VALUE_TYPE = "true"
| "false"
| "1"
| "0"
WS_INTxxx_VALUE_TYPE = sign? digits
WS_UINTxxx_VALUE_TYPE = digits
WS_FLOAT_VALUE_TYPE = WS_DOUBLE_VALUE_TYPE
WS_DOUBLE_VALUE_TYPE = sign? digits ("." digits)? exponent?
| "NaN"
| "INF"
| "-INF"
WS_DECIMAL_VALUE_TYPE = sign? digits ("." digits)?
WS_GUID_VALUE_TYPE = xxxxxxxx "-" xxxx "-" xxxx "-" xxxx "-" xxxxxxxxxxxx
WS_TIMESPAN_VALUE_TYPE = sign? (digits ".")? hh ":" mm ":" ss ("." d7)?
WS_DATETIME_VALUE_TYPE = yyyy "-" MM "-" dd "T" hh ":" mm ":" ss ("." d7)? tz?
WS_DURATION_VALUE_TYPE = sign? "P" (digits "Y") (digits "M")? (digits "D")?
| sign? "P" (digits "Y")? (digits "M")? (digits "D")?
| sign? "P" (digits "Y")? (digits "M")? (digits "D")
| sign? "P" (digits "Y")? (digits "M")? (digits "D")? "T" (digits "H") (digits "M")? (digits ("." digits)? "S")?
| sign? "P" (digits "Y")? (digits "M")? (digits "D")? "T" (digits "H")? (digits "M") (digits ("." digits)? "S")?
| sign? "P" (digits "Y")? (digits "M")? (digits "D")? "T" (digits "H")? (digits "M")? (digits ("." digits)? "S")
sign = "-"
| "+"
exponent = E sign? digits
| e sign? digits
digits = [0-9]+
x = [0-9]
| [A-F]
| [a-f]
yyyy = 1-9999
hh = 0-23
mm = 0-59
ss = 0-59
MM = 1-31
tz = "Z"
| sign hh ":" mm
d7 = digit digit? digit? digit? digit? digit? digit?
Requisitos
| Cliente mínimo com suporte | Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | webservices.h |
| Biblioteca | WebServices.lib |
| DLL | WebServices.dll |