WsSetMessageProperty-Funktion (webservices.h)

  • Artikel

Mit diesem Vorgang wird eine Nachrichteneigenschaft festgelegt.

Syntax

HRESULT WsSetMessageProperty(
  [in]           WS_MESSAGE             *message,
  [in]           WS_MESSAGE_PROPERTY_ID id,
                 const void             *value,
  [in]           ULONG                  valueSize,
  [in, optional] WS_ERROR               *error
);

Parameter

[in] message

Ein Zeiger auf das Message-Objekt mit der festzulegenden Eigenschaft. Der Zeiger muss auf ein gültiges WS_MESSAGE-Objekt verweisen, und der Wert, auf den verwiesen wird, ist möglicherweise nicht NULL.

[in] id

Der Bezeichner der festzulegenden Eigenschaft.

value

Ein Zeiger auf den festzulegenden Eigenschaftswert. Der Zeiger muss über eine Ausrichtung verfügen, die mit dem Typ der Eigenschaft kompatibel ist.

[in] valueSize

Die Größe des Eigenschaftswerts in Bytes.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
E_INVALIDARG
 Die Eigenschafts-ID wurde für dieses Objekt nicht unterstützt.

Die angegebene Größe war für die -Eigenschaft nicht geeignet.
E_OUTOFMEMORY
 Es war nicht genügend Speicherplatz vorhanden, um den Eigenschaftswert festzulegen.
Andere Fehler
Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

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