Funzione WsCombineUrl (webservices.h)

Articolo
03/15/2023

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
E_INVALIDARG	Uno o più argomenti non sono validi.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
WS_E_INVALID_FORMAT	L'URL di base o l'URL di riferimento non era nel formato corretto o aveva uno schema non riconosciuto.
Altri errori	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

Condividi tramite