WsCreateXmlBuffer-Funktion (webservices.h)

  • Artikel

Erstellt einen XML-Puffer , der zum Verarbeiten von XML-Daten verwendet werden kann.

Syntax

HRESULT WsCreateXmlBuffer(
  [in]           WS_HEAP                      *heap,
                 const WS_XML_BUFFER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 WS_XML_BUFFER                **buffer,
  [in, optional] WS_ERROR                     *error
);

Parameter

[in] heap

Zeiger auf die WS_HEAP-Struktur , die den Heap darstellt, von dem Speicher für den zurückgegebenen XML-Puffer zugewiesen werden soll.

properties

Ein Array von WS_XML_BUFFER_PROPERTY Strukturen, die optionale Eigenschaften für den XML-Puffer enthalten.

Der Wert dieses Parameters kann NULL sein. In diesem Fall muss der propertyCount-Parameter 0 (null) sein.

[in] propertyCount

Die Anzahl der Eigenschaften im Eigenschaftenarray .

buffer

Bei Erfolg ein Zeiger, der die Adresse der WS_XML_BUFFER Struktur empfängt, die den erstellten XML-Puffer darstellt. Der Speicher für diesen Puffer wird freigegeben, wenn sein Heap zurückgesetzt oder freigegeben wird.

Der XML-Puffer ist zunächst leer.

[in, optional] error

Zeiger auf eine WS_ERROR-Struktur , die zusätzliche Fehlerinformationen empfängt, wenn die Funktion fehlschlägt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie NO_ERROR zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode Beschreibung
E_OUTOFMEMORY
 Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.
E_INVALIDARG
 Mindestens ein Argument ist ungültig.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile webservices.h
Bibliothek WebServices.lib
DLL WebServices.dll