Función UrlGetPartA (shlwapi.h)

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

Sintaxis

LWSTDAPI UrlGetPartA(
  [in]      PCSTR pszIn,
  [out]     PSTR  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 de

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

[in, out] pcchOut

Tipo: DWORD* de

Puntero a un valor que, en la entrada, se establece en el número de caracteres del búfer de pszOut. Cuando esta función se 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 de

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

URL_PART_HOSTNAME

Nombre de host.

URL_PART_PASSWORD

La contraseña.

URL_PART_PORT

Número de puerto.

URL_PART_QUERY

Parte de la consulta de la dirección URL.

URL_PART_SCHEME

Esquema de dirección URL.

URL_PART_USERNAME

Nombre de usuario.

dwFlags

Tipo: DWORD de

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 la terminación NULL. 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 lo contrario, se devuelve un valor de error COM.

Observaciones

Requisitos