2.9 KiB
title, description, ms.assetid, ms.reviewer, manager, ms.author, ms.topic, ms.prod, ms.technology, author, ms.date
| title | description | ms.assetid | ms.reviewer | manager | ms.author | ms.topic | ms.prod | ms.technology | author | ms.date |
|---|---|---|---|---|---|---|---|---|---|---|
| ICSPNode Copy | ICSPNode Copy | cd5ce0bc-a08b-4f82-802d-c7ff8701b41f | dansimp | dansimp | article | w10 | windows | manikadhiman | 06/26/2017 |
ICSPNode::Copy
This method makes a copy of the current node at the specified path within the configuration service provider. If the target node exists, it should be overwritten.
Syntax
HRESULT Copy([in] IConfigManager2URI* puriDestination,
[in, out] ICSPNode** ppNewNode,
[in, out] DWORD* pgrfNodeOptions);
Parameters
puriDestination
Path and name of new node's location, relative to the configuration service provider's root node.
ppNewNode
New node created by the copy operation.
pgrfNodeOptions
Features supported on the new node.
| Feature name | Bit value (in hex) | Notes |
|---|---|---|
|
0x01 |
The native security option signifies that the node handles its own security checking, and that ConfigManager2 does not have to manage security for this node. |
|
0x02 |
The internal transactioning option tells ConfigManager2 that the configuration service provider handles the transactioning (rollback and commitment) for the node. To handle internal transactioning, the node must implement the ICSPNodeTransactioning. |
|
0x04 |
Unused. |
|
0x08 |
Unused. |
Return Value
A value of S_OK indicates that the node was successfully copied to the new location. CFGMGR_E_COMMANDNOTALLOWED indicates that this node does not support the Copy method.
Remarks
For externally–transactioned nodes, if this method is implemented, then ICSPNode::Add, ICSPNode::SetValue, ICSPNode::Clear, and ICSPNode::DeleteChild must also be implemented or rollback will fail.
Requirements
Header: None