Funzione WsGetMessageProperty (webservices.h)

  • Articolo

Recupera una proprietà dell'oggetto Message specificata. La proprietà da recuperare è identificata da un parametro di input WS_MESSAGE_PROPERTY_ID .

Sintassi

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

Parametri

[in] message

Puntatore a un oggetto Message contenente la proprietà desiderata. Questo parametro deve essere un oggetto WS_LISTENER valido.

[in] id

Si tratta di un valore enumeratore WS_MESSAGE_PROPERTY_ID che identifica la proprietà desiderata.

value

Riferimento a un percorso per l'archiviazione del valore della proprietà recuperata. Il puntatore deve avere un allineamento compatibile con il tipo della proprietà .

[in] valueSize

Dimensione del buffer di lunghezza byte allocata dal chiamante per archiviare il valore della proprietà recuperato.

[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
E_INVALIDARG
 L'ID proprietà non è supportato per questo oggetto o il buffer specificato non è abbastanza grande per il valore.
E_OUTOFMEMORY
 L'applicazione ha esaurito la memoria.
Altri errori
Questa funzione può restituire altri errori non elencati in precedenza.

Requisiti

   
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