WsGetMissingMetadataDocumentAddress-Funktion (webservices.h)

  • Artikel

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:
 

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