获取包含此文档上下文文档的可显示的名称。
HRESULT GetName(
GETNAME_TYPE gnType,
BSTR* pbstrFileName
);
int GetName(
enum_GETNAME_TYPE gnType,
out string pbstrFileName
);
参数
gnType
[in] 从指定的名称类型返回的 GETNAME_TYPE 枚举的值。pbstrFileName
[out] 返回文件的名称。
返回值
如果成功，则返回; S_OK否则，返回错误代码。
备注
此方法通常向前到 IDebugDocument2:: GetName 方法的调用，因此，除非文档上下文编写存储文档名称 (例如显示)。
示例
下面的示例演示如何执行显示 IDebugDocumentContext2 接口的简单 CDebugContext 对象的方法。
HRESULT CDebugContext::GetName(GETNAME_TYPE gnType, BSTR* pbstrFileName)
{
HRESULT hr;
// Check for a valid file name argument.
if (pbstrFileName)
{
*pbstrFileName = NULL;
switch (gnType)
{
case GN_NAME:
case GN_FILENAME:
{
// Copy the member file name into the local file name.
*pbstrFileName = SysAllocString(m_sbstrFileName);
// Check for successful copy.
hr = (*pbstrFileName) ? S_OK : E_OUTOFMEMORY;
break;
}
default:
{
hr = E_FAIL;
break;
}
}
}
else
{
hr = E_INVALIDARG;
}
return hr;
}