Funzione WsDecodeUrl (webservices.h)

Articolo
03/03/2024

Valuta i componenti di un URL per determinare il relativo "schema". Un valore WS_URL_SCHEME_TYPE viene incapsulato in una struttura WS_URL e viene restituito un riferimento alla struttura tramite il parametro di output. Se lo schema non viene riconosciuto, la funzione restituisce WS_E_INVALID_FORMAT.
Sono supportati solo i tipi di schema identificati in WS_URL_SCHEME_TYPE .

Sintassi

HRESULT WsDecodeUrl(
  [in]           const WS_STRING *url,
  [in]           ULONG           flags,
  [in]           WS_HEAP         *heap,
                 WS_URL          **outUrl,
  [in, optional] WS_ERROR        *error
);

Parametri

[in] url

Puntatore a una rappresentazione WS_STRING dell'URL da valutare.

[in] flags

Determina il metodo di valutazione dello schema URL. Vedere WS_URL_FLAGS.

[in] heap

Puntatore a un WS_HEAP in cui allocare il riferimento URL restituito.

outUrl

Riferimento alla struttura WS_URL che incapsula il valore WS_URL_SCHEME_TYPE .

[in, optional] error

Puntatore a un oggetto WS_ERROR in cui devono essere archiviate informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
E_INVALIDARG	Uno o più argomenti non sono validi.
E_OUTOFMEMORY	Memoria insufficiente.
WS_E_INVALID_FORMAT	L'URL di input non era nel formato corretto o lo schema non è stato riconosciuto.
Altri errori	Questa funzione può restituire altri errori non elencati in precedenza.

Commenti

La grammatica analizzata per gli schemi "http", "https", "net.tcp" e "soap.udp" è disponibile in http://www.ietf.org/rfc/rfc3986.txt. Per questi schemi:

È necessario un nome host non vuoto.
Per la produzione di valori letterali IP vengono restituiti tutti i caratteri delimitati da "[" e "]". Non vengono applicati per seguire la produzione IPv6Address.
La parte userinfo dell'autorità (ad esempio, userinfo@hostname:port) non è supportata.

Se non viene specificata alcuna porta, viene restituita la porta predefinita per lo schema.

Se non viene specificata alcuna porta per lo schema soap.udp 0xFFFFFFFF viene restituita come predefinita.

Requisiti

Requisito	Valore
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