Funzione WsCombineUrl (webservices.h)
Produce un URL assoluto da un riferimento URL specificato (URL assoluto o relativo) e da un URL di base assoluto specificato.
Sintassi
HRESULT WsCombineUrl(
[in] const WS_STRING *baseUrl,
[in] const WS_STRING *referenceUrl,
[in] ULONG flags,
[in] WS_HEAP *heap,
[out] WS_STRING *resultUrl,
[in, optional] WS_ERROR *error
);
Parametri
[in] baseUrl
Puntatore a una struttura WS_STRING contenente un URL assoluto in formato codificato.
[in] referenceUrl
Puntatore a una struttura WS_STRING contenente un URL assoluto o relativo in formato codificato.
[in] flags
Controlla il formato dell'URL risultante. Per altre informazioni, vedere WS_URL_FLAGS.
[in] heap
Puntatore all'oggetto WS_HEAP da cui viene allocata la memoria per l'URL risultante.
[out] resultUrl
Puntatore a una struttura WS_STRING che riceve l'URL risultante. Si tratta di un URL assoluto in formato codificato.
[in, optional] error
Puntatore a una struttura WS_ERROR che riceve informazioni aggiuntive sull'errore se la funzione ha esito negativo.
Valore restituito
Se la funzione ha esito positivo, restituisce NO_ERROR; in caso contrario, restituisce un codice di errore HRESULT.
Codice restituito | Descrizione |
---|---|
|
Uno o più argomenti non sono validi. |
|
Memoria insufficiente per completare l'operazione. |
|
L'URL di base o l'URL di riferimento non era nel formato corretto o aveva uno schema non riconosciuto. |
|
Questa funzione può restituire altri errori non elencati in precedenza. |
Commenti
Se l'URL di riferimento è assoluto, viene restituito invariato, se i flag specificati sono consentiti. Se l'URL di riferimento è relativo, viene combinato con l'URL di base prima di essere restituito.
Sono supportati solo gli schemi elencati in WS_URL_SCHEME_TYPE .
Requisiti
Client minimo supportato | Windows 7 [app desktop | App UWP] |
Server minimo supportato | Windows Server 2008 R2 [app desktop | App UWP] |
Piattaforma di destinazione | Windows |
Intestazione | webservices.h |
Libreria | WebServices.lib |
DLL | WebServices.dll |