Funzione WsReadMetadata (webservices.h)

Articolo
08/27/2023

Legge un elemento Metadata e lo aggiunge ai documenti Metadata dell'oggetto Metadata.

Lo stato dell'oggetto Metadata deve essere impostato su WS_METADATA_STATE_CREATED.

In caso di errore, lo stato dell'oggetto Metadata viene reimpostato su WS_METADATA_STATE_FAULTED.

Nota La funzione utilizzerà un elemento se l'elemento contiene metadati. Se l'elemento non viene riconosciuto come contenente metadati o il tipo specifico di metadati non è necessario, l'elemento non viene letto.

Sintassi

HRESULT WsReadMetadata(
  [in]           WS_METADATA     *metadata,
  [in]           WS_XML_READER   *reader,
  [in]           const WS_STRING *url,
  [in, optional] WS_ERROR        *error
);

Parametri

[in] metadata

Puntatore all'oggetto Metadata per l'archiviazione dei metadati letti. Il puntatore deve fare riferimento a un oggetto WS_METADATA valido.

[in] reader

Puntatore all'oggetto Lettore XML utilizzato per leggere i metadati. Il puntatore deve fare riferimento a un oggetto WS_XML_READER valido e il lettore deve essere posizionato sull'elemento contenente i metadati desiderati.

[in] url

Puntatore a un oggetto WS_STRING che fa riferimento all'URL dei metadati recuperato. L'URL viene usato per tenere traccia dei documenti di metadati per la risoluzione dei collegamenti basati su URL tra documenti.

Nota L'URL DEVE essere completo. L'URL può avere un identificatore di frammento.

Sono supportati gli schemi URL seguenti:

WS_URL_HTTP_SCHEME_TYPE
WS_URL_HTTPS_SCHEME_TYPE
WS_URL_NETTCP_SCHEME_TYPE

Ogni URL specificato con questa funzione deve avere un URL di base univoco. L'URL di base viene calcolato rimuovendo qualsiasi identificatore di frammento dall'URL specificato.

Ad esempio, se sono stati specificati gli URL seguenti:


http://example.com/document1#fragment
http://example.com/document2

I due URL di base sono:


http://example.com/document1
http://example.com/document2

[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
WS_E_INVALID_FORMAT	I dati di input non erano nel formato previsto o non hanno il valore previsto.
WS_E_INVALID_OPERATION	L'operazione non è consentita a causa dello stato corrente dell'oggetto .
WS_E_QUOTA_EXCEEDED	È stata superata una quota.
E_OUTOFMEMORY	Memoria insufficiente.
E_INVALIDARG	Uno o più argomenti non sono validi.
S_FALSE	L'elemento non è stato utilizzato.
Altri errori	Questa funzione può restituire altri errori non elencati in precedenza.

Commenti

Questa funzione riconosce i tipi di metadati seguenti:

Documenti WSDL 1.1
documenti WS-Policy 1.2

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