Funzione WsMoveWriter (webservices.h)

  • Articolo

Sposta la posizione corrente del writer come specificato dal parametro moveTo.

Sintassi

HRESULT WsMoveWriter(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_MOVE_TO    moveTo,
                 BOOL          *found,
  [in, optional] WS_ERROR      *error
);

Parametri

[in] writer

Writer da spostare.

[in] moveTo

Posizione relativa per spostare il writer.

found

Se non è NULL, se la nuova posizione potrebbe essere spostata qui.

Se si tratta di NULL e la posizione non è stata spostata in, la funzione restituirà WS_E_INVALID_FORMAT. Vedere Valori restituiti da Servizi Web Windows.

[in, optional] error

Specifica la posizione in cui devono essere archiviate informazioni aggiuntive sugli errori 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.
WS_E_INVALID_OPERATION
 L'operazione non è consentita a causa dello stato corrente dell'oggetto.
WS_E_INVALID_FORMAT
 I dati di input non erano nel formato previsto o non hanno il valore previsto.

Commenti

Questa operazione può essere usata solo in un writer impostato su un WS_XML_BUFFER.

Se il parametro trovato non è NULL, indicherà se potrebbe spostarsi nel nodo richiesto e restituire NOERROR.

Se il parametro trovato è NULL e il nodo richiesto non viene trovato, restituirà WS_E_INVALID_FORMAT.

Una volta posizionata, il writer inserisce quindi nuovi dati prima della posizione specificata.

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