MQMailParseBody

The MQMailParseBody function parses the body of an MSMQ mail message and places the information in a mail data structure.

STDAPI MQMailParseBody(
  ULONG cbBuffer,             
  LPBYTE FAR *pbBuffer,       
  LPMQMailEMail FAR *ppEMail  
);
 

Parameters

cbBuffer

[in] Buffer size.

pbBuffer

[in] Pointer to the buffer containing the body of the MSMQ mail message.

ppEMail

[out] Pointer to where the address of the newly allocated MQMailEMail structure that contains the copied mail information.

Return Values

S_OK

Indicates success.

E_INVALIDARG

Invalid arguments.

Other system errors

Use the FAILED(hr) macro to test for errors.

Remarks

The MQMailParseBody function is used to convert the body of an MSMQ mail message so its information can be used by an MSMQ application.

The application must free the memory allocated for the MQMailEMail object once the parsed information is used. To free the memory call MQMailFreeMemory.

MSMQ mail messages can be received from another MSMQ application or either of the two MSMQ Mail services: MSMQ MAPI Transport Provider or the MSMQ Exchange Connector.

See Also

MQMailEMail, MQMailFreeMemory

© 1997 by Microsoft Corporation. All rights reserved.