Compartilhar via

Função WsEncodeUrl (webservices.h)

  • Artigo

Codifica o WS_URL especificado em uma cadeia de caracteres de URL dadas as partes do componente. Os valores são escapados conforme necessário, combinados e armazenados no WS_HEAP especificado e o resultado é retornado como um WS_STRING.

Sintaxe

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

Parâmetros

[in] url

Uma referência à WS_URL a ser codificada.

[in] flags

O valor desse parâmetro 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 URL.

[out] outUrl

Um ponteiro para a cadeia de caracteres de URL resultante.

[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
 Os dados de URL codificados não eram válidos de acordo com a sintaxe da URL.
Outros erros
Essa função pode retornar outros erros não listados acima.

Comentários

Se um esquema não for reconhecido no parâmetro url , a função retornará WS_E_INVALID_FORMAT.
Há suporte apenas para tipos de esquema identificados em WS_URL_SCHEME_TYPE .

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