다음을 통해 공유

IDebugDocumentContext2::GetName

  • 아티클

이 문서 컨텍스트를 포함하는 문서의 표시 가능한 이름을 가져옵니다.

구문

int GetName(
    enum_GETNAME_TYPE  gnType,
    out string         pbstrFileName
);

매개 변수

gnType
[in] 반환할 이름의 형식을 지정하는 GETNAME_TYPE 열거형의 값입니다.

pbstrFileName
[out] 파일의 이름을 반환합니다.

Return Value

성공하면 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;
}

참고 항목