ISettingsEngine::GetNamespace method (wcmconfig.h)

Opens an existing namespace as specified by the ISettingsIdentity parameter.

Syntax

HRESULT GetNamespace(
  [in]  ISettingsIdentity  *SettingsID,
  [in]  WcmNamespaceAccess Access,
  [in]  void               *Reserved,
  [out] ISettingsNamespace **NamespaceItem
);

Parameters

[in] SettingsID

An ISettingsIdentity object that specifies an existing namespace to get.

[in] Access

A WcmNamespaceAccess value that specifies the type of access, whether it is read-only or read and write access.

[in] Reserved

Reserved. Must be NULL.

[out] NamespaceItem

A pointer to an ISettingsNamespace object that is the result of the get operation.

Return value

This method can return one of these values.

Return code Description
S_OK
Indicates success.
WCM_E_USERNOTFOUND
Indicates that the store is not currently loaded.
WCM_E_NAMESPACENOTFOUND
Indicates that the provided identity does not match a namespace registered in the store.

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

ISettingsEngine