Funzione WsGetMissingMetadataDocumentAddress (webservices.h)

Articolo
08/27/2023

Questa funzione restituisce l'indirizzo di un documento mancante a cui fa riferimento l'oggetto metadati.

Ogni documento aggiunto all'oggetto metadati può contenere riferimenti ad altri documenti. Dopo che un documento è stato aggiunto di nuovo alla funzione Metadati, è possibile usare per trovare il documento mancante successivo.

Nota Questa funzione avrà esito negativo se il nome host dell'URL dell'indirizzo mancante restituito non può essere verificato come uno dei nomi host previsti. I nomi host previsti sono un'unione dei seguenti:

Nome host di qualsiasi URL passato in precedenza a WsReadMetadata.
Elenco di nomi host specificati utilizzando la proprietà WS_METADATA_PROPERTY_HOST_NAMES .

Sintassi

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

Parametri

[in] metadata

Questo parametro è un puntatore a un oggetto Metadata che deve avere il documento.

address

In caso di esito positivo, questo parametro viene popolato con un puntatore all'indirizzo di un documento di metadati mancante o NULL se non sono presenti documenti di metadati mancanti.

L'URL dell'indirizzo restituito è completo.

Nota I dati restituiti da questa funzione sono validi fino a quando l'oggetto metadati non viene liberato o reimpostato. I dati non devono essere modificati.

[in, optional] error

Questo parametro è un puntatore WS_ERROR in cui devono essere archiviate informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
E_INVALIDARG	Uno o più argomenti non sono validi.
E_OUTOFMEMORY	Memoria insufficiente.
Altri errori	Questa funzione può restituire altri errori non elencati in precedenza.

Commenti

Se questa funzione verificherà o meno i nomi host degli URL restituiti possono essere controllati usando il valore dell'enumeratore WS_METADATA_PROPERTY_VERIFY_HOST_NAMES .

Lo scopo della verifica del nome host è garantire che un'applicazione non usi l'indirizzo senza sapere che proviene da un host da cui è disposto ad accettare i metadati.

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Condividi tramite