共用方式為


IDebugDocumentContext2::GetName

取得包含此檔案內容的可顯示檔名稱。

語法

int GetName(
    enum_GETNAME_TYPE  gnType,
    out string         pbstrFileName
);

參數

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;
}

另請參閱