Funzione WsEncodeUrl (webservices.h)

Articolo
03/03/2024

Codifica l'WS_URL specificata in una stringa URL in base alle parti del componente. I valori vengono eliminati in base alle esigenze, combinati e archiviati nella WS_HEAP specificata e il risultato viene restituito come WS_STRING.

Sintassi

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

Parametri

[in] url

Riferimento alla WS_URL da codificare.

[in] flags

Il valore di questo parametro determina il metodo di valutazione dello schema URL. Vedere WS_URL_FLAGS.

[in] heap

Puntatore a un WS_HEAP in cui allocare l'URL.

[out] outUrl

Puntatore alla stringa URL risultante.

[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	I dati URL codificati non sono validi in base alla sintassi dell'URL.
Altri errori	Questa funzione può restituire altri errori non elencati sopra.

Commenti

Se un schema non viene riconosciuto nel parametro URL , la funzione restituisce WS_E_INVALID_FORMAT.
Sono supportati solo i tipi di schema identificati in WS_URL_SCHEME_TYPE .

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