Función TranslateURLW (intshcut.h)

  • Artículo

Aplica traducciones comunes a una cadena de dirección URL determinada, creando una nueva cadena de dirección URL.

Sintaxis

INTSHCUTAPI HRESULT TranslateURLW(
        PCWSTR pcszURL,
        DWORD  dwInFlags,
  [out] PWSTR  *ppszTranslatedURL
);

Parámetros

pcszURL

Tipo: PCTSTR

Dirección de la cadena de dirección URL que se va a traducir.

dwInFlags

Tipo: DWORD

Marcas de bits que especifican cómo se va a traducir la cadena de dirección URL. Este valor puede ser una combinación de lo siguiente:

TRANSLATEURL_FL_GUESS_PROTOCOL

Si el esquema de protocolo no se especifica en el parámetro pcszURL para TranslateURL, el sistema elige automáticamente un esquema y lo agrega a la dirección URL.

TRANSLATEURL_FL_USE_DEFAULT_PROTOCOL

Si el esquema de protocolo no se especifica en el parámetro pcszURL a TranslateURL, el sistema agrega el protocolo predeterminado a la dirección URL.

[out] ppszTranslatedURL

Tipo: PTSTR*

Variable de puntero que recibe el puntero a la cadena de dirección URL traducida recién creada, si existe. El parámetro ppszTranslatedURL solo es válido si la función devuelve S_OK.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si la dirección URL se realizó correctamente o S_FALSE si la dirección URL no requería traducción. Si se produce un error, la función devuelve uno de los valores siguientes.

Código devuelto Descripción
E_FLAGS
 La combinación de marcas pasada en dwInFlags no es válida.
E_OUTOFMEMORY
 No había memoria suficiente para completar la operación.
E_POINTER
 Uno de los punteros de entrada no es válido.

Comentarios

Esta función no valida la cadena de dirección URL de entrada. Un valor devuelto correcto no indica que las cadenas de dirección URL son direcciones URL válidas.

Nota:

El encabezado intshcut.h define TranslateURL como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado intshcut.h
Archivo DLL Url.dll