TranslateVirtualName

Translates a virtual repeated capability name to a physical repeated capability name.

Syntax

virtual CString TranslateVirtualName(const CString& strVirtualName) const abstract;

Parameters

strVirtualName

[in] Virtual name to be translated.

Return value

Returns the physical name if the translation was successful, otherwise strVirtualName is returned.

Remarks

This function uses the physical-to-virtual name mappings created by the end user in the IVI Configuration Store. If the specified strVirtual does not have a physical name mapping, this function simply returns strVirtual.

Example

The following example demonstrates use of the TranslateVirtualName function.

HRESULT Acme4321::ConfigureChannel(BSTR bstrName)
{
  HRESULT hr = S_OK;

  CString strVirtualName = COLE2T(bstrName);
  CString strPhysicalName = TranslateVirtualName(strVirtualName);

  return hr;
}