Funzione UrlGetPartA (shlwapi.h)

Accetta una stringa URL e restituisce una parte specificata di tale URL.

Sintassi

LWSTDAPI UrlGetPartA(
  [in]      PCSTR pszIn,
  [out]     PSTR  pszOut,
  [in, out] DWORD *pcchOut,
            DWORD dwPart,
            DWORD dwFlags
);

Parametri

[in] pszIn

Tipo: PCTSTR

Stringa con terminazione null di lunghezza massima INTERNET_MAX_URL_LENGTH contenente l'URL.

[out] pszOut

Tipo: PTSTR

Puntatore a un buffer che, quando questa funzione restituisce correttamente, riceve una stringa con terminazione null con la parte specificata dell'URL.

[in, out] pcchOut

Tipo: DWORD*

Puntatore a un valore che, nella voce, è impostato sul numero di caratteri nel buffer pszOut . Quando questa funzione restituisce correttamente, il valore dipende dal fatto che la funzione abbia esito positivo o restituisca E_POINTER. Per altri valori restituiti, il valore di questo parametro è senza significato.

dwPart

Tipo: DWORD

Flag che specificano quale parte dell'URL recuperare. Può avere uno dei valori seguenti.

URL_PART_HOSTNAME

Nome host.

URL_PART_PASSWORD

Password.

URL_PART_PORT

Il numero della porta.

URL_PART_QUERY

Parte della query dell'URL.

URL_PART_SCHEME

Schema dell'URL.

URL_PART_USERNAME

Nome utente.

dwFlags

Tipo: DWORD

Flag che può essere impostato per mantenere lo schema URL, oltre alla parte specificata da dwPart.

URL_PARTFLAG_KEEPSCHEME

Mantenere lo schema URL.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se riuscito. Il valore a cui fa riferimento pcchOut verrà impostato sul numero di caratteri scritti nel buffer di output, escluso il valore null di terminazione. Se il buffer era troppo piccolo, E_POINTER viene restituito e il valore a cui punta da pcchOut verrà impostato sul numero minimo di caratteri che il buffer deve essere in grado di contenere, incluso il carattere NULL terminante. In caso contrario, viene restituito un valore di errore COM.

Commenti

Requisiti