WsGetMissingMetadataDocumentAddress-Funktion (webservices.h)

Artikel
08/27/2023

Diese Funktion gibt die Adresse eines fehlenden Dokuments zurück, auf das das Metadatenobjekt verweist.

Jedes Dokument, das dem Metadatenobjekt hinzugefügt wird, kann Verweise auf andere Dokumente enthalten. Nachdem ein Dokument den Metadaten wieder hinzugefügt wurde, kann die Funktion verwendet werden, um das nächste fehlende Dokument zu finden.

Hinweis Diese Funktion schlägt fehl, wenn der Hostname der URL der fehlenden Adresse, die zurückgegeben wird, nicht als einer der erwarteten Hostnamen überprüft werden kann. Die erwarteten Hostnamen sind eine Union der folgenden:

Der Hostname einer url, die zuvor an WsReadMetadata übergeben wurde.
Die Liste der Hostnamen, die mit der WS_METADATA_PROPERTY_HOST_NAMES-Eigenschaft angegeben werden.

Syntax

HRESULT WsGetMissingMetadataDocumentAddress(
  [in]           WS_METADATA         *metadata,
                 WS_ENDPOINT_ADDRESS **address,
  [in, optional] WS_ERROR            *error
);

Parameter

[in] metadata

Dieser Parameter ist ein Zeiger auf ein Metadata-Objekt , das das Dokument enthalten soll.

address

Bei erfolgreicher Ausführung wird dieser Parameter entweder mit einem Zeiger auf die Adresse eines fehlenden Metadatendokuments oder mit NULL gefüllt, wenn keine Metadatendokumente fehlen.

Die zurückgegebene Adress-URL ist voll qualifiziert.

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

[in, optional] error

Dieser Parameter ist ein WS_ERROR Zeiger auf den Ort, an 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	Mindestens ein Argument ist ungültig.
E_OUTOFMEMORY	Der Arbeitsspeicher ist nicht mehr vorhanden.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Ob diese Funktion die Hostnamen der zurückgegebenen URLs überprüft, kann mithilfe des WS_METADATA_PROPERTY_VERIFY_HOST_NAMES Enumeratorwerts gesteuert werden.

Der Zweck der Hostnamenüberprüfung besteht darin, sicherzustellen, dass eine Anwendung die Adresse nicht verwendet, ohne zu wissen, dass sie von einem Host stammt, von dem sie Metadaten akzeptieren möchte.

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

Freigeben über