IDebugDocumentContext2::GetName
取得包含此檔案內容的可顯示檔名稱。
語法
參數
gnType
[in]GETNAME_TYPE 列舉中的值,指定要傳回的名稱類型。
pbstrFileName
[out]傳回檔案的名稱。
傳回值
如果成功,則會傳回 S_OK
;否則,會傳回錯誤碼。
備註
此方法通常會將呼叫轉送至 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;
}