Funzione UrlGetPartW (shlwapi.h)

Articolo
11/20/2024

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

Sintassi

LWSTDAPI UrlGetPartW(
  [in]      PCWSTR pszIn,
  [out]     PWSTR  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 che contiene l'URL.

[out] pszOut

Tipo: PTSTR

Puntatore a un buffer che, quando la funzione viene restituita 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, viene impostato sul numero di caratteri nel buffer pszOut. Quando questa funzione viene restituita 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 è privo di 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

Numero di porta.

URL_PART_QUERY

Parte della query dell'URL.

URL_PART_SCHEME

Schema 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 in caso di esito positivo. Il valore a cui punta pcchOut verrà impostato sul numero di caratteri scritti nel buffer di output, escluso il null. Se il buffer è troppo piccolo, viene restituito E_POINTER e il valore a cui punta pcchOut verrà impostato sul numero minimo di caratteri che il buffer deve essere in grado di contenere, incluso il carattere di terminazione NULL. In caso contrario, viene restituito un valore di errore COM.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 5.0 o successiva)

Condividi tramite