Compartilhar via

Função WsDecodeUrl (webservices.h)

  • Artigo

Avalia os componentes de uma URL para determinar seu "esquema". Um valor WS_URL_SCHEME_TYPE é encapsulado em uma estrutura de WS_URL e uma referência à estrutura é retornada por meio do parâmetro de saída. Se o esquema não for reconhecido, a função retornará WS_E_INVALID_FORMAT.
Há suporte apenas para tipos de esquema identificados em WS_URL_SCHEME_TYPE .

Sintaxe

HRESULT WsDecodeUrl(
  [in]           const WS_STRING *url,
  [in]           ULONG           flags,
  [in]           WS_HEAP         *heap,
                 WS_URL          **outUrl,
  [in, optional] WS_ERROR        *error
);

Parâmetros

[in] url

Um ponteiro para uma representação WS_STRING da URL a ser avaliada.

[in] flags

Determina o método de avaliação do esquema de URL. Consulte WS_URL_FLAGS.

[in] heap

Um ponteiro para um WS_HEAP no qual alocar a referência de URL retornada.

outUrl

Referência à estrutura WS_URL que encapsula o valor WS_URL_SCHEME_TYPE .

[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.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
E_INVALIDARG
 Um ou mais argumentos são inválidos.
E_OUTOFMEMORY
 Ficou sem memória.
WS_E_INVALID_FORMAT
 A URL de entrada não estava no formato correto ou o esquema não foi reconhecido.
Outros erros
Essa função pode retornar outros erros não listados acima.

Comentários

A gramática analisada para os esquemas "http", "https", "net.tcp" e "soap.udp" pode ser encontrada em http://www.ietf.org/rfc/rfc3986.txt. Para esses esquemas:

  • Um nome de host não vazio é necessário.
  • Para a produção literal de IP, todos os caracteres demarcados por "[" e "]" são retornados. Elas não são impostas para seguir a produção IPv6Address.
  • Não há suporte para a parte de autoridade userinfo (por exemplo, userinfo@hostname:port).

Se nenhuma porta for especificada, a porta padrão para esse esquema será retornada.

Se nenhuma porta for especificada para o esquema soap.udp 0xFFFFFFFF será retornada como padrão.

Requisitos

Requisito Valor
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