Funzione InternetCreateUrlW (wininet.h)

Articolo
08/27/2023

Crea un URL dalle parti del componente.

Sintassi

BOOL InternetCreateUrlW(
  [in]      LPURL_COMPONENTSW lpUrlComponents,
  [in]      DWORD             dwFlags,
  [out]     LPWSTR            lpszUrl,
  [in, out] LPDWORD           lpdwUrlLength
);

Parametri

[in] lpUrlComponents

Puntatore a una struttura URL_COMPONENTS che contiene i componenti da cui creare l'URL.

[in] dwFlags

Controlla l'operazione di questa funzione. Questo parametro può essere uno o più dei valori seguenti.

Valore	Significato
ICU_ESCAPE	Converte tutti i caratteri non sicuri nelle sequenze di escape corrispondenti nella stringa di percorso a cui punta il membro lpszUrlPath e in lpszExtraInfo la stringa extra-information puntata al membro della struttura URL_COMPONENTS puntata dal parametro lpUrlComponents . La versione Unicode di InternetCreateUrl tenterà prima di tutto di convertire usando la tabella codici del sistema. Se non riesce, torna a UTF-8.
ICU_USERNAME	Obsoleto: ignorato.

Valore

Significato

ICU_ESCAPE

Converte tutti i caratteri non sicuri nelle sequenze di escape corrispondenti nella stringa di percorso a cui punta il membro lpszUrlPath e in lpszExtraInfo la stringa extra-information puntata al membro della struttura URL_COMPONENTS puntata dal parametro lpUrlComponents .

La versione Unicode di InternetCreateUrl tenterà prima di tutto di convertire usando la tabella codici del sistema. Se non riesce, torna a UTF-8.

ICU_USERNAME

Obsoleto: ignorato.

[out] lpszUrl

Puntatore a un buffer che riceve l'URL.

[in, out] lpdwUrlLength

Puntatore a una variabile che specifica le dimensioni del buffer URL lpszUrl , in TCHARs. Quando la funzione restituisce, questo parametro riceve le dimensioni della stringa URL, escluso il terminatore NULL. Se GetLastError restituisce ERROR_INSUFFICIENT_BUFFER, questo parametro riceve il numero di byte necessari per contenere l'URL creato.

Valore restituito

Restituisce TRUE se la funzione ha esito positivo o FALSE in caso contrario. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Quando si specifica lo schema nella struttura URL_COMPONENTS passato a lpUrlComponents, se lpszScheme non è NULL, verrà usato per lo schema. Se lpszScheme è NULL, è possibile specificare lo schema usando l'enumerazione INTERNET_SCHEME impostandonScheme sul INTERNET_SCHEME o INTERNET_SCHEME_DEFAULT richiesto.

Nota WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni o i servizi server usano Microsoft Windows HTTP Services (WinHTTP).

Nota

L'intestazione wininet.h definisce InternetCreateUrl 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

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wininet.h
Libreria	Wininet.lib
DLL	Wininet.dll

Vedi anche

Gestione di localizzatori di risorse uniformi

Funzioni WinINet

Condividi tramite