Compartir a través de

Función WSDUriEncode (wsdutil.h)

  • Artículo

Codifica un URI según las reglas de codificación de URI en RFC2396.

Sintaxis

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

Parámetros

[in] source

Contiene el URI que se va a codificar.

[in] cchSource

Especifica la longitud del origen en caracteres.

[out] destOut

Puntero a una cadena que contiene el URI codificado. Si destOut no es NULL, la aplicación que realiza la llamada debe liberar la cadena asignada llamando a WSDFreeLinkedMemory.

[out, optional] cchDestOut

Especifica la longitud de destOut en caracteres.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 La función se completó correctamente.
E_INVALIDARG
 source es NULL o cchSource es 0.
E_FAIL
 La longitud en caracteres de origen supera WSD_MAX_TEXT_LENGTH (8192).
E_POINTER
 destOut es NULL.

Comentarios

WSDUriEncode codifica determinados caracteres en el origen en un formato de codificación con escape de %XY, donde X e Y son dígitos hexadecimales correspondientes a la representación de un solo byte de ese carácter. Los caracteres anchos que ocupan varios bytes se representan primero en formato multi bytes UTF-8 y, a continuación, se escapan en caracteres codificados.

WSDUriEncode no codifica caracteres alfanuméricos de un solo byte. Codifica los signos de porcentaje (%) en el origen.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wsdutil.h (incluya Wsdapi.h)
Library Wsdapi.lib
Archivo DLL Wsdapi.dll