Funzione WsReadEndpointAddressExtension (webservices.h)

Articolo
03/03/2024

Legge un'estensione del WS_ENDPOINT_ADDRESS.

Sintassi

HRESULT WsReadEndpointAddressExtension(
  [in]           WS_XML_READER                      *reader,
  [in]           WS_ENDPOINT_ADDRESS                *endpointAddress,
  [in]           WS_ENDPOINT_ADDRESS_EXTENSION_TYPE extensionType,
  [in]           WS_READ_OPTION                     readOption,
  [in]           WS_HEAP                            *heap,
                 void                               *value,
  [in]           ULONG                              valueSize,
  [in, optional] WS_ERROR                           *error
);

Parametri

[in] reader

Lettore XML da utilizzare per leggere l'estensione.

La funzione imposterà automaticamente l'input del lettore in base alle esigenze per leggere le estensioni.

[in] endpointAddress

Indirizzo dell'endpoint contenente le estensioni.

[in] extensionType

Tipo di estensione da leggere.

[in] readOption

Indica se il valore è obbligatorio e come allocare il valore. Per altre informazioni, vedere WS_READ_OPTION .

Questo parametro deve avere uno dei valori seguenti:

[in] heap

Heap da usare per archiviare il valore letto.

value

Indirizzo di un buffer in cui inserire il valore letto.

Se si usa WS_READ_REQUIRED_VALUE per il parametro readOption, il buffer deve essere la dimensione del tipo di estensione da leggere(che varia in base WS_ENDPOINT_ADDRESS_EXTENSION_TYPE).

Se si usano WS_READ_REQUIRED_POINTER o WS_READ_OPTIONAL_POINTER, il buffer deve essere la dimensione di un puntatore.

[in] valueSize

Dimensione del buffer allocata dal chiamante per il valore letto.

Questa dimensione deve corrispondere alle dimensioni del buffer passato usando il parametro value.

[in, optional] error

Specifica dove archiviare 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	Tipo di estensione non valido. Le dimensioni del buffer fornito non sono corrette. Un parametro obbligatorio è NULL.
WS_E_INVALID_FORMAT	I dati di input non erano nel formato previsto o non hanno il valore previsto.
E_OUTOFMEMORY	Memoria insufficiente.
Altri errori	Questa funzione può restituire altri errori non elencati in precedenza.

Commenti

Il valore restituito è valido fino a quando l'heap non viene liberato o reimpostato.

Se il tipo di estensione richiesto viene visualizzato più volte nel buffer delle estensioni, viene restituita la prima istanza.

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