Compartir a través de

Función TranslateURLA (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 TranslateURLA(
        PCSTR pcszURL,
        DWORD dwInFlags,
  [out] PSTR  *ppszTranslatedURL
);

Parámetros

pcszURL

Tipo: PCTSTR

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

dwInFlags

Tipo: DWORD de

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 no se especifica el esquema de protocolo 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 no se especifica el esquema de protocolo en el parámetro pcszURL para 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 recién creada traducida, 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 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.

Observaciones

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 Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de intshcut.h
DLL de Url.dll