Compartilhar via


Função WSDUriDecode (wsdutil.h)

Decodifica um URI de acordo com as regras em RFC2396.

Sintaxe

HRESULT WSDUriDecode(
  [in]            LPCWSTR source,
  [in]            DWORD   cchSource,
  [out]           LPWSTR  *destOut,
  [out, optional] DWORD   *cchDestOut
);

Parâmetros

[in] source

Contém o URI a ser decodificado.

[in] cchSource

Especifica o comprimento da origem em caracteres.

[out] destOut

Ponteiro para uma cadeia de caracteres que contém o URI decodificado. Se destOut não for NULL, o aplicativo de chamada deverá liberar a cadeia de caracteres alocada chamando WSDFreeLinkedMemory.

[out, optional] cchDestOut

Especifica o comprimento de destOut em caracteres.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
Função concluída com êxito.
E_INVALIDARG
source é NULL ou cchSource é 0.
E_FAIL
O comprimento em caracteres de origem excede WSD_MAX_TEXT_LENGTH (8192).
E_POINTER
destOut é NULL.

Comentários

O WSDUriDecode decodifica todos os caracteres codificados na origem. Esses caracteres são identificados por um sinal de porcentagem (%) seguido por dois dígitos hexadecimal. O WSDUriDecode decodifica componentes de byte único de caracteres de vários bytes e os converte novamente em uma representação de caractere largo no destOut.

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]
Plataforma de Destino Windows
Cabeçalho wsdutil.h (inclua Wsdapi.h)
Biblioteca Wsdapi.lib
DLL Wsdapi.dll