Table of contents
TOC
Collapse the table of content
Expand the table of content

ICSPNode::DeleteChild

Last Updated: 10/28/2016

Deletes the specified child node from the configuration service provider node. ICSPNode::Clear must always be called first on the child node that is to be deleted.

Syntax

HRESULT DeleteChild([in] IConfigManager2URI* puriChildToDelete);

Parameters

puriChildToDelete
      The name of the child node to delete.

Return Values

Return ValueDescription
CFGMGR_E_NODENOTFOUNDThe child node does not exist
CFGMGR_E_COMMANDNOTALLOWEDThe child node to be deleted is a read-only node
S_OKSuccess.

A value of S_OK indicates that a node was successfully deleted. CFGMGR_E_NODENOTFOUND indicates that the child node does not exist. CFGMGR_E_COMMANDNOTALLOWED indicates that this node does not support the ICSP::DeleteChild method, or that the child node to be deleted is a read-only node.

Remarks

For externally–transactioned nodes, if this method is implemented, then ICSPNode::Add must also be implemented or rollback will fail.

Requirements

Header: None

Create a custom configuration service provider

© 2017 Microsoft