Export (0) Print
Expand All

IWbemPath::SetText method

The IWbemPath::SetText method parses a path so that information on the path can be returned by the path parser. Typically, this is the first method called by users of the interface. The only case in which this is not the first method called is when the calling code is constructing the path by specifying each piece separately.

Syntax


HRESULT SetText(
  [in]  ULONG   uMode,
  [in]  LPCWSTR pszPath
);

Parameters

uMode [in]

Flag specifying the type of paths accepted.

ValueMeaning
WBEMPATH_CREATE_ACCEPT_RELATIVE

Allow paths without server names.

WBEMPATH_CREATE_ACCEPT_ABSOLUTE

Reserved for future use.

WBEMPATH_CREATE_ACCEPT_ALL

Allow setting an empty path (which additionally clears out the object), Also allows paths which have just the server names, or paths which don't have server names.

WBEMPATH_TREAT_SINGLE_IDENT_AS_NS

A simple path, such as "XYZ" is interpreted as a namespace.

 

pszPath [in]

Path to be parsed.

Return value

This method returns an HRESULT indicating the status of the method call.

Return codeDescription
S_OK

Method executed successfully.

WBEM_E_INVALID_PARAMETER

Either the flags or the text parameter contain invalid values.

WBEM_E_OUT_OF_MEMORY

Out of memory.

 

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

Wmiutils.h

Library

Wbemuuid.lib

DLL

Wmiutils.dll

See also

IWbemPath

 

 

Show:
© 2015 Microsoft