ITuningSpace::get_DefaultLocator Method

The get_DefaultLocator method retrieves the default locator for this tuning space.

Syntax

HRESULT get_DefaultLocator(
  [out]  ILocator **ppLocatorVal
);

Parameters

• ppLocatorVal [out]
  Address of a variable that receives a pointer to ILocator interface. The caller must release the interface.

Return Value

Returns S_OK if successful. If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.

Remarks

The tuning space might not have a default locator. It is the application's responsibility to provide a default locator for the tuning space if needed.

If the tuning space does not have a default locator, this method succeeds but returns the value NULL in the ppLocatorVal parameter. Check for a NULL value before attempting to dereference the pointer.

Requirements

See Also

ITuningSpace Interface
ITuningSpace::put_DefaultLocator

Send comments about this topic to Microsoft

Build date: 12/4/2008