WsCombineUrl-Funktion (webservices.h)

  • Artikel

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.

Rückgabecode Beschreibung
E_INVALIDARG
 Mindestens ein Argument ist ungültig.
E_OUTOFMEMORY
 Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.
WS_E_INVALID_FORMAT
 Die Basis-URL oder Verweis-URL hatte nicht das richtige Format oder ein Schema, das nicht erkannt wurde.
Andere Fehler
Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

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

   
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile webservices.h
Bibliothek WebServices.lib
DLL WebServices.dll