ImageGear Professional v18.2 > API Reference Guide > ART Component API Reference > ART Component Functions Reference > Global Named Block Management Functions > ART_global_block_delete |
This function deletes an existing global named block, lpBlockName, from the set of global named blocks.
Copy Code
|
|
---|---|
AT_ERRCOUNT ART_global_block_delete(
HIGEAR hIGear,
const LPART_BLOCK_NAME lpBlockName
);
|
Name | Type | Description |
hIGear | HIGEAR | HIGEAR handle to the image. |
lpBlockName | const LPART_BLOCK_NAME | A far pointer to an 8-byte memory array contains the type of block to delete. The block type is either an ART-defined constant beginning with ART_BLOCK or a user-defined block. See ARTAPI.H for the full list of ART-defined constants. |
Returns the number of ImageGear errors that occurred during the function call.
All pixel formats supported by ImageGear Professional.
None
Copy Code
|
|
---|---|
HIGEAR hIGear; /* HIGEAR handle of image */ nErrcount = ART_global_block_delete(hIGear,"NOTES\000\000\000"); |
Reserved named blocks cannot be deleted. However, they may be modified by calling ART_global_block_create() function.
An error is set if any of the following conditions are met: