WsGetMetadataEndpoints-Funktion (webservices.h)

Artikel
08/27/2023

Gibt die in den Metadatenobjektdokumenten definierten "Endpunkte" zurück. Wenn Sie diese Funktion aufrufen , WS_METADATA_STATEauf WS_METADATA_STATE_CREATED festgelegt ist, löst das Metadatenobjekt alle Verweise in den Metadatendokumenten auf. Jede zusätzliche Dokumentvalidierung wird ebenfalls durchgeführt. Wenn dieser Prozess erfolgreich ist, wird das Metadatenobjekt auf WS_METADATA_STATE_RESOLVED festgelegt, und nachfolgende Dokumentzusätze zum Metadatenobjekt sind nicht zulässig. Wenn ein Fehler auftritt, wird das Metadatenobjekt auf WS_METADATA_STATE_FAULTED festgelegt.

Hinweis Die von dieser Funktion zurückgegebenen Daten sind gültig, bis das Metadatenobjekt freigegeben oder zurückgesetzt wird. Die von dieser Funktion zurückgegebenen Daten sollten nicht geändert werden.

Syntax

HRESULT WsGetMetadataEndpoints(
  [in]           WS_METADATA           *metadata,
  [out]          WS_METADATA_ENDPOINTS *endpoints,
  [in, optional] WS_ERROR              *error
);

Parameter

[in] metadata

Ein Zeiger auf ein Metadata-Objekt , das die gewünschten Endpunkte enthält. Dieser Parameter muss ein gültiges WS_METADATA-Objekt sein.

[out] endpoints

Bei Erfolg wird dieser Zeigerparameter mit Informationen zu den Endpunkten aufgefüllt, die im Metadatenobjekt definiert wurden.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
E_INVALIDARG	Die Eigenschafts-ID wurde für dieses Objekt nicht unterstützt, oder der angegebene Puffer war nicht groß genug für den Wert.
E_OUTOFMEMORY	Unzureichende Speicherressourcen.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Diese Eigenschaft kann im zustand WS_METADATA_STATE_CREATED oder WS_METADATA_STATE_RESOLVED verwendet werden.

Diese Funktion schlägt fehl, wenn Metadatendokumente fehlen. Verwenden Sie WsGetMissingMetadataDocumentAddress , um die Adresse fehlender Dokumente zu ermitteln.

Anforderungen

Anforderung	Wert
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

Freigeben über