[in] Physical name to be translated.
TranslatePhysicalName
Translates a physical repeated capability name to a virtual repeated capability name.
Syntax
Section titled “Syntax”virtual CString TranslatePhysicalName(const CString& strPhysicalName) const abstract;Parameters
Section titled “Parameters”strPhysicalName
Return value
Section titled “Return value”Returns the virtual name if the translation was successful, otherwise strPhysicalName is returned.
Remarks
Section titled “Remarks”This function uses the physical-to-virtual name mappings created by the end user in the IVI Configuration Store. If strPhysical does not have a virtual name mapping, this function simply returns strPhysical.
Example
Section titled “Example”The following example demonstrates use of the TranslatePhysicalName function.
HRESULT Acme4321::GetChannelName(BSTR* pbstrName){ HRESULT hr = S_OK;
CString strPhysicalName = "CH1";
// Always hand out virtual names to the user CString strVirtualName = TranslatePhysicalName(strPhysicalName);
*pbstrName = strVirtualName.AllocSysString();
return hr;}