Partager via

PROPERTYINST

  • Article

The PROPERTYINST structure defines an instance of a property in a piece of recognized data. Network Monitor allocates and fills in a PROPERTYINST structure when a property is attached to the capture.

typedef struct _PROPERTYINST {
  LPPROPERTYINFO lpPropertyInfo;
  LPSTR szPropertyText;
  union {
    LPVOID lpData;
    ULPBYTE lpByte;
    ULPWORD lpWord;
    ULPDWORD lpDword;
    ULPLARGEINT lpLargeInt;
    ULPSYSTEMTIME lpSysTime;
    LPPROPERTYINSTEX lpPropertyInstEx;
  };
  WORD DataLength;
  WORD Level  :4;
  WORD HelpID  :12;
  DWORD IFlags;
} PROPERTYINST, 
 *LPPROPERTYINST;

Members

  • lpPropertyInfo
    Pointer to the PROPERTYINFO structure that defines the property.

  • szPropertyText
    Pointer to a string that is displayed in the details pane of the Network Monitor UI.

  • lpData
    Pointer to the start of the data for the property. The parser determines where the property data starts.

  • lpByte
    Pointer to the BYTE data.

  • lpWord
    Pointer to the WORD data.

  • lpDword
    Pointer to the DWORD data.

  • lpLargeInt
    Pointer to the LARGEINT data.

  • lpSysTime
    Pointer to the SYSTEMTIME data.

  • lpPropertyInstEx
    Pointer to a PROPERTYINSTEX structure. The lpPropertyInstEx member is used only when you call AttachPropertyInstanceEx.

    If lpPropertyInstEx is used, you must set the DataLength member to 0xFFFF.

  • DataLength
    Data length for this instance of the property. If the lpPropertyInstEx member points to a PROPERTYINSTEX structure, you must set DataLength to 0xFFFF.

  • Level
    Level information.

  • HelpID
    Help file context identifier.

  • IFlags
    Error condition flag.

Remarks

The PROPERTYINST structure defines an instance of an attached property. The parser accesses the PROPERTYINST structure through several helper functions. For example, when the FormatPropertyInstance function is called to format the data of a property, it modifies the szPropertyText member of the PROPERTYINST structure.

Requirements

Client Requires Windows XP, Windows 2000 Professional, or Windows NT Workstation 4.0.
Server Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.
Header

Declared in Netmon.h.

See Also

AttachPropertyInstance, AttachPropertyInstanceEx