Funzione WsGetMetadataEndpoints (webservices.h)

Articolo
03/09/2024

Restituisce l'oggetto "Endpoint" definito all'interno dei documenti dell'oggetto metadati. La chiamata a questa funzione con WS_METADATA_STATEimpostata su WS_METADATA_STATE_CREATED causerà la risoluzione di tutti i riferimenti nei documenti dei metadati. Verrà eseguita anche la convalida di documenti aggiuntivi. Se questo processo ha esito positivo, l'oggetto metadati verrà impostato su WS_METADATA_STATE_RESOLVED e le aggiunte successive del documento all'oggetto metadati non sono consentite. Se si verifica un errore, l'oggetto metadati verrà impostato su WS_METADATA_STATE_FAULTED.

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

Sintassi

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

Parametri

[in] metadata

Puntatore a un oggetto Metadata contenente gli endpoint desiderati. Questo parametro deve essere un oggetto WS_METADATA valido.

[out] endpoints

In caso di esito positivo, questo parametro puntatore viene popolato con informazioni sugli endpoint definiti nell'oggetto metadati.

[in, optional] error

Puntatore a un oggetto 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	L'ID della proprietà non è stato supportato per questo oggetto o il buffer specificato non è stato sufficiente per il valore.
E_OUTOFMEMORY	Risorse di memoria insufficienti.
Altri errori	Questa funzione può restituire altri errori non elencati sopra.

Commenti

Questa proprietà può essere usata in WS_METADATA_STATE_CREATED o WS_METADATA_STATE_RESOLVED stato.

Questa funzione avrà esito negativo se sono presenti documenti di metadati mancanti. Usare WsGetMissingMetadataDocumentAddress per determinare l'indirizzo di eventuali documenti mancanti.

Requisiti

Requisito	Valore
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