Compartilhar via

Função WSDUriEncode (wsdutil.h)

  • Artigo

Codifica um URI de acordo com as regras de codificação de URI no RFC2396.

Sintaxe

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

Parâmetros

[in] source

Contém o URI a ser codificado.

[in] cchSource

Especifica o comprimento da origem em caracteres.

[out] destOut

Ponteiro para uma cadeia de caracteres que contém o URI codificado. 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 WSDUriEncode codifica determinados caracteres na origem em um formato de codificação de escape de %XY, em que X e Y são dígitos hexadecimal correspondentes à representação de byte único desse caractere. Caracteres largos que ocupam vários bytes são renderizados primeiro em formato de vários bytes UTF-8 e, em seguida, escapam para caracteres codificados.

O WSDUriEncode não codifica caracteres alfanuméricos de byte único. Ele codifica sinais de porcentagem (%) na origem.

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