RemoveFromBlob function

The RemoveFromBlob function deletes any level of BLOB entry (Owner, Category, or Tag).

Syntax

DWORD RemoveFromBlob(
  _In_       HBLOB hBlob,
  _In_ const char  *pOwnerName,
  _In_ const char  *pCategoryName,
  _In_ const char  *pTagName
);

Parameters

hBlob [in]

Handle to the BLOB from which an entry is deleted.

pOwnerName [in]

Pointer to the Owner name.

pCategoryName [in]

Pointer to the Category name. A NULL parameter value indicates the caller is attempting to delete the given Owner information and all of its child entries. Note that if the pCategoryName parameter value is NULL, the pTagName parameter must also be NULL.

pTagName [in]

Pointer to the Tag name. A NULLpTagName value indicates the caller is attempting to delete the given Category and all of its child entries. If the parameter value is not NULL, the caller is asking that only that the specified Tag entries be deleted.

Return value

If the function is successful, the return value is NMERR_SUCCESS.

If the function is unsuccessful, the return value is a NMERR value that indicates the error.

Requirements