IWbemContext::Clone

[This is preliminary documentation and subject to change.]

The IWbemContext::Clone method makes a logical copy of the current IWbemContext object. This method can be useful when many calls must be made which have largely identical IWbemContext objects.

HRESULT Clone(
  [out] IWbemContext **ppNewCopy  
);

Parameters

ppNewCopy: Must point to NULL on entry. It receives a pointer to the new object containing the clone of the current object. The returned pointer has a positive reference count. The caller must call Release on this pointer when it is no longer needed. This pointer is set to NULL when there are errors; a new object is not returned.

Return Values

WBEM_E_FAILED	General failure.
WBEM_E_INVALID_PARAMETER	NULL was specified as a parameter, which is not legal.
WBEM_E_OUT_OF_MEMORY	There is not enough memory to clone the object.
WBEM_NO_ERROR	Success.