The AttachPropertyInstance function attaches a property instance to a frame, thus creating a PROPERTYINST structure for that frame in the PROPERTYINSTTABLE for the frame.
DWORD AttachPropertyInstance(
HFRAME hFrame,
HPROPERTY hProperty,
DWORD Length,
LPVOID lpData,
DWORD HelpID,
DWORD IndentLevel,
DWORD IFlags
);
1 | IFLAG_ERROR |
2 | IFLAG_SWAPPED (WORD or DWORD byte is non-Intel format at attach time) |
4 | IFLAG_UNICODE (STRING is UNICODE at attach time) |
Note that earlier parsers set the fError DWORD to 0 or 1, which will map to IFLAG_ERROR.
The return value is the error code.
Error code | Meaning |
---|---|
BHERR_SUCCESS | No problems were encountered. |
BHERR_INVALID_HPROPERTY | The hProperty was invalid. |
BHERR_INVALID_HFRAME | The hFrame was invalid. |
This function is used to attach a property instance to a frame, thus creating a PROPERTYINST structure for that frame in the PROPERTYINSTTABLE for the frame. This function will add the information to the frame as a PROPERTYINST structure.