WsCombineUrl-Funktion (webservices.h)

Erzeugt eine absolute URL aus einem angegebenen URL-Verweis (absolute oder relative URL) und einer angegebenen absoluten Basis-URL.

Syntax

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
);

Parameter

[in] baseUrl

Zeiger auf eine WS_STRING-Struktur , die eine absolute URL im codierten Format enthält.

[in] referenceUrl

Zeiger auf eine WS_STRING-Struktur , die eine absolute oder relative URL im codierten Format enthält.

[in] flags

Steuert das Format der resultierenden URL. Weitere Informationen finden Sie unter WS_URL_FLAGS.

[in] heap

Zeiger auf das WS_HEAP-Objekt , aus dem der Arbeitsspeicher für die resultierende URL zugeordnet wird.

[out] resultUrl

Zeiger auf eine WS_STRING Struktur, die die resultierende URL empfängt. Dies ist eine absolute URL im codierten Format.

[in, optional] error

Zeiger auf eine WS_ERROR-Struktur , die zusätzliche Fehlerinformationen empfängt, wenn die Funktion fehlschlägt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird NO_ERROR zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Wenn die Verweis-URL absolut ist, wird sie unverändert zurückgegeben, wenn die angegebenen Flags zulassen. Wenn die Verweis-URL relativ ist, wird sie mit der Basis-URL kombiniert, bevor sie zurückgegeben wird.

Nur die in WS_URL_SCHEME_TYPE aufgeführten Schemas werden unterstützt.

Anforderungen