IBackgroundCopyFile2::SetRemoteName 메서드
원격 이름을 다운로드 작업의 새 URL로 변경합니다.
구문
HRESULT SetRemoteName(
[in] LPCWSTR RemoteName
);
매개 변수
-
RemoteName [in]
-
서버에서 파일의 이름을 포함하는 Null로 종료된 문자열입니다. 원격 이름을 지정하는 방법에 대한 자세한 내용은 RemoteName 멤버를 참조하세요.
반환 값
이 메서드는 다음 반환 값뿐만 아니라 다른 값을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
Success |
|
새 원격 이름이 잘못된 URL이거나 새 URL이 너무 깁니다(URL은 2,200자를 초과할 수 없음). |
설명
일반적으로 파일을 전송하는 데 사용되는 URL을 변경하거나 파일 이름 또는 경로를 변경하려는 경우 이 메서드를 호출합니다.
이 메서드는 반환할 때 직렬화되지 않습니다. 변경 사항을 직렬화하려면 작업을 일시 중단하고 , 이 메서드를 호출하고(작업에서 여러 파일을 변경하는 경우 루프를 사용) 작업을 다시 시작 합니다. IBackgroundCopyJob::Resume 메서드를 호출하면 변경 내용이 직렬화됩니다.
새 원격 이름의 타임스탬프로 또는 파일 크기가 이전 원격 이름과 다르거나 새 서버가 검사점 다시 시작을 지원하지 않는 경우(HTTP 원격 이름에 대해) 배달 최적화가 다운로드를 다시 시작합니다. 그렇지 않으면 새 서버의 동일한 위치에서 전송이 다시 시작됩니다. 배달 최적화는 이미 전송된 파일을 다시 시작하지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 10 버전 1709 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server, 버전 1709 [데스크톱 앱만 해당] |
| 헤더 |
|
| IDL |
|
| 라이브러리 |
|
| DLL |
|
| IID |
IID_IBackgroundCopyFile2 83e81b93-0873-474d-8a8c-f2018b1a939c로 정의됩니다. |