WsGetMetadataEndpoints-Funktion (webservices.h)

  • Artikel

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