windows-itpro-docs/windows/client-management/mdm/iconfigserviceprovider2getnode.md

title, description, ms.assetid, ms.author, ms.topic, ms.prod, ms.technology, author, ms.date

title	description	ms.assetid	ms.author	ms.topic	ms.prod	ms.technology	author	ms.date
IConfigServiceProvider2 GetNode	IConfigServiceProvider2 GetNode	4dc10a59-f6a2-45c0-927c-d594afc9bb91	maricia	article	w10	windows	MariciaAlforque	06/26/2017

IConfigServiceProvider2::GetNode

This method returns a node from the configuration service provider based on the path that was passed in. The returned node is a descendent of the root node.

Syntax

HRESULT GetNode([in] IConfigManager2URI* pURI, 
                [out] ICSPNode** ppNode,
                [in, out] DWORD* pgrfNodeOptions);

Parameters

pUri

• URI of the child node, relative to the root node. For example, to access the "./Vendor/Contoso/SampleCSP/ContainerA/UserName" node, ConfigManager2 calls the configuration service provider's `GetNode` method and passes in an IConfigManager2URI instance representing the URI “SampleCSP/ContainerA/UserName”.

*ppNode*

• If the query is successful, this returns the ICSPNode instance at the *pUri* location in the configuration service provider's tree.

*pgrfNodeOptions*

• Nodes support the following features.

  Feature name	Bit value (in hex)	Notes
  CSPNODE_OPTION_NATIVESECURITY	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.
  CSPNODE_OPTION_INTERNALTRANSACTION	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](icspnodetransactioning.md).
  CSPNODE_OPTION_HANDLEALLPROPERTIES	0x04	Unused.
  CSPNODE_OPTION_SECRETDATA	0x08	Unused.

Return Value

This method returns an ICSPNode. If the function returns null, call GetLastError to get the error value.

A value of S_OK indicates that a node was successfully found. CFGMGR_E_NODENOTFOUND indicates that the node does not exist. Note that this may be normal, as in the case of optional nodes.

Requirements

Header: None