Edit

ISettingsItem::GetChild method (wcmconfig.h)

  • Article

Gets the child item that has the specified name.

Syntax

HRESULT GetChild(
  [in]  const WCHAR   *Name,
  [out] ISettingsItem **Child
);

Parameters

[in] Name

The name of the child item.

[out] Child

A pointer to an ISettingsItem object that corresponds to the child item.

Return value

This method can return one of these values.

Return code Description
S_OK
 Indicates success.
WCM_E_STATENODENOTFOUND
 Indicates that the requested name is not a child of the item.
WCM_E_WRONGESCAPESTRING
 Indicates that the name contains an unrecognized XML escape sequence.
WCM_E_INVALIDPATH
 Indicates that the name is not formatted correctly.
WCM_E_INVALIDKEY
Indicates that the path is incorrectly specified and references the wrong key for the list item.
HRESULT_FROM_WIN32(ERROR_INVALID_OPERATION)
 Indicates that the item does not support children.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header wcmconfig.h
DLL SMIEngine.dll

See also

ISettingsItem