IBackgroundCopyFile::GetLocalName 메서드(bits.h)

파일의 로컬 이름을 검색합니다.

구문

HRESULT GetLocalName(
  [out] LPWSTR *pVal
);

매개 변수

[out] pVal

클라이언트에서 파일의 이름을 포함하는 Null로 종료된 문자열입니다. 이름은 정규화되어 있습니다. 완료되면 CoTaskMemFree 함수를 호출하여 ppName을 해제합니다.

반환 값

이 메서드는 성공 시 S_OK 반환하거나 오류 발생 시 표준 COM HRESULT 값 중 하나를 반환합니다.

설명

로컬 파일 이름은 IBackgroundCopyJob 인터페이스의 AddFile 또는 AddFileSet 메서드를 호출할 때 설정됩니다.

예제

다음 예제에서는 에서 로컬 및 원격 파일 이름 및 진행률 관련 정보를 검색하는 방법을 보여줍니다.
IBackgroundCopyFile 인터페이스. 이 예제에서는 IBackgroundCopyFile 인터페이스 포인터가 유효하다고 가정합니다.

IBackgroundCopyFile* pFile;
HRESULT hr;
WCHAR* pszLocalFileName = NULL;
WCHAR* pszRemoteFileName = NULL;
WCHAR  szPercentComplete[4+1];
BG_FILE_PROGRESS Progress;

hr = pFile->GetLocalName(&pszLocalFileName);
if (SUCCEEDED(hr))
{
  hr = pFile->GetRemoteName(&pszRemoteFileName);
  if (SUCCEEDED(hr))
  {
    pFile->GetProgress(&Progress);
    if (BG_SIZE_UNKNOWN == Progress.BytesTotal) 
    {
      StringCchPrintf(szPercentComplete, sizeof(szPercentComplete), L"0%%");
    } 
    else 
    {
      StringCchPrintf(szPercentComplete, sizeof(szPercentComplete), L"%I64d%%", 
          100*Progress.BytesTransferred/Progress.BytesTotal); 
    }
    //Do something with the file names and progress information.
  }
}
if (pszLocalFileName)
  CoTaskMemFree(pszLocalFileName);
if (pszRemoteFileName)
  CoTaskMemFree(pszRemoteFileName);

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP
지원되는 최소 서버	Windows Server 2003
대상 플랫폼	Windows
헤더	bits.h
라이브러리	Bits.lib
DLL	QmgrPrxy.dll

추가 정보

IBackgroundCopyFile

IBackgroundCopyFile::GetRemoteName

IBackgroundCopyJob::AddFile

IBackgroundCopyJob::AddFileSet