Compartilhar via

Função WsCombineUrl (webservices.h)

  • Artigo

Produz uma URL absoluta de uma referência de URL especificada (URL absoluta ou relativa) e uma URL base absoluta especificada.

Sintaxe

HRESULT WsCombineUrl(
  [in]           const WS_STRING *baseUrl,
  [in]           const WS_STRING *referenceUrl,
  [in]           ULONG           flags,
  [in]           WS_HEAP         *heap,
  [out]          WS_STRING       *resultUrl,
  [in, optional] WS_ERROR        *error
);

Parâmetros

[in] baseUrl

Ponteiro para uma estrutura WS_STRING que contém uma URL absoluta no formato codificado.

[in] referenceUrl

Ponteiro para uma estrutura WS_STRING que contém uma URL absoluta ou relativa no formato codificado.

[in] flags

Controla o formato da URL resultante. Para obter mais informações, consulte WS_URL_FLAGS.

[in] heap

Ponteiro para o objeto WS_HEAP do qual a memória da URL resultante é alocada.

[out] resultUrl

Ponteiro para uma estrutura WS_STRING que recebe a URL resultante. Essa é uma URL absoluta no formato codificado.

[in, optional] error

Ponteiro para uma estrutura de WS_ERROR que recebe informações de erro adicionais se a função falhar.

Valor retornado

Se a função for bem-sucedida, ela retornará NO_ERROR; caso contrário, ele retorna um código de erro HRESULT.

Código de retorno Descrição
E_INVALIDARG
 Um ou mais argumentos não são válidos.
E_OUTOFMEMORY
 Memória insuficiente para concluir a operação.
WS_E_INVALID_FORMAT
 A URL base ou a URL de referência não estavam no formato correto ou tinham um esquema que não era reconhecido.
Outros erros
Essa função pode retornar outros erros não listados acima.

Comentários

Se a URL de referência for absoluta, ela será retornada inalterada, se os sinalizadores especificados permitirem. Se a URL de referência for relativa, ela será combinada com a URL base antes de ser retornada.

Somente os esquemas listados em WS_URL_SCHEME_TYPE têm suporte.

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