DeleteBookmarkDefinition

The DeleteBookmarkDefinition method deletes an existing bookmark definition.

HRESULT DeleteBookmarkDefinition(

[in] SHORT p_nHeading,

[in] SHORT p_nDefinition,

[in, string] LPCWSTR p_wsProfileName,

[in] BOOL p_bPublicProfile

);

Parameters:

p_nHeading

[in]heading index

p_nDefinition

[in] definition index

p_wsProfileName

[in] pointer to a null terminated Unicode string containing the profile to modify. If this parameter is an empty string, the current active profile is used.

p_bPublicProfile

[in] Flag if the profile is a public or a private profile.

Return values:

S_OK on success or COM error code

NV_NOT_INITIALIZED - Initialize was not called

NV_INVALID_BOOKMARK_HEAD - wrong bookmark header index

NV_INVALID_BOOKMARK_DEF - wrong bookmark definition index

NV_PUBLIC_PROFILE - you cannot change public profiles only on server

Remarks:

When you delete a bookmark definition the indexes for the remaining definitions will be recalculated. If you delete the last definition for a heading, the heading will be also deleted. In this case, the remaining heading indexes will be also recalculated.