Compartir a través de

Función UrlGetPartW (shlwapi.h)

  • Artículo

Acepta una cadena de dirección URL y devuelve una parte especificada de esa dirección URL.

Sintaxis

LWSTDAPI UrlGetPartW(
  [in]      PCWSTR pszIn,
  [out]     PWSTR  pszOut,
  [in, out] DWORD  *pcchOut,
            DWORD  dwPart,
            DWORD  dwFlags
);

Parámetros

[in] pszIn

Tipo: PCTSTR

Cadena terminada en null de longitud máxima INTERNET_MAX_URL_LENGTH que contiene la dirección URL.

[out] pszOut

Tipo: PTSTR

Puntero a un búfer que, cuando esta función devuelve correctamente, recibe una cadena terminada en null con la parte especificada de la dirección URL.

[in, out] pcchOut

Tipo: DWORD*

Un puntero a un valor que, en la entrada, se establece en el número de caracteres del búfer pszOut . Cuando esta función devuelve correctamente, el valor depende de si la función es correcta o devuelve E_POINTER. Para otros valores devueltos, el valor de este parámetro no tiene sentido.

dwPart

Tipo: DWORD

Marcas que especifican qué parte de la dirección URL se va a recuperar. Puede tener uno de los valores siguientes.

URL_PART_HOSTNAME

El nombre de host.

URL_PART_PASSWORD

La contraseña.

URL_PART_PORT

Número del puerto.

URL_PART_QUERY

Parte de la consulta de la dirección URL.

URL_PART_SCHEME

El esquema de URL.

URL_PART_USERNAME

El nombre de usuario.

dwFlags

Tipo: DWORD

Marca que se puede establecer para mantener el esquema de dirección URL, además de la parte especificada por dwPart.

URL_PARTFLAG_KEEPSCHEME

Mantenga el esquema de dirección URL.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente. El valor al que apunta pcchOut se establecerá en el número de caracteres escritos en el búfer de salida, excepto el valor NULL de terminación. Si el búfer era demasiado pequeño, se devuelve E_POINTER y el valor al que apunta pcchOut se establecerá en el número mínimo de caracteres que debe contener el búfer, incluido el carácter NULL de terminación. De lo contrario, se devuelve un valor de error COM.

Comentarios

Nota

El encabezado shlwapi.h define UrlGetPart como un 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h
Library Shlwapi.lib
Archivo DLL Shlwapi.dll (versión 5.0 o posterior)