TranslateVirtualName

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

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.

C++

Copy

// CoAcme4321.cpp
HRESULT Acme4321::ConfigureChannel(BSTR bstrName)
{
  HRESULT hr = S_OK;

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

  return hr;
}

Other Resources

TranslatePhysicalName

Repeated Capabilities