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
Nota
L'intestazione shlwapi.h definisce UrlGetPart come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Client minimo supportato | Windows 2000 Professional, Windows XP [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | shlwapi.h |
Libreria | Shlwapi.lib |
DLL | Shlwapi.dll (versione 5.0 o successiva) |