NNTPHEADERRESP structure

[NNTPHEADERRESP is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

This structure will be returned in response to the GetHeaders command. Because the number of headers requested may be large, OnResponse may be called multiple times in response to this command. rgHeaders is not accumulated by the transport between calls to OnResponse therefore it is the responsibility of the caller to store this information as it is retrieved. When all the data is retrieved, then fDone will be set to TRUE. Since not all servers provide the XREF: header in their XOVER records, fSupportsXRef will be set to TRUE if the pszXref field in NNTPHEADER is valid. If this is FALSE, the client can retrieve this header with a call to CommandXHDR.

Syntax

typedef struct tagNNTPHEADERRESP {
  DWORD        cHeaders;
  LPNNTPHEADER rgHeaders;
  BOOL         fSupportsXRef;
  DWORD_PTR    dwReserved;
} NNTPHEADERRESP, *LPNNTPHEADERRESP;

Members

cHeaders

Type: DWORD

Number of headers in rgHeaders

rgHeaders

Type: LPNNTPHEADER

Array of header structures

fSupportsXRef

Type: BOOL

TRUE if the headers have a valid pszXref value. Otherwise, the client needs to issue an XHdr to retrieve that value if they're interested.

dwReserved

Type: DWORD_PTR

Reserved for system use

Requirements

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Product	Outlook Express 6.0
Header	Imnxport.h
IDL	Imnxport.idl