CopyRecord 메서드(ADO)

레코드가 나타내는 엔터티를 다른 위치에 복사합니다.

구문

  
Record.CopyRecord (Source, Destination, UserName, Password, Options, Async)  

매개 변수

원본
(선택 사항) 복사할 엔터티(예: 파일 또는 디렉터리)를 지정하는 URL이 포함된 String 값입니다. Source를 생략하거나 빈 문자열을 지정하면 현재 Record가 나타내는 파일 또는 디렉터리가 복사됩니다.

대상
선택 사항입니다. Source를 복사할 위치를 지정하는 URL이 포함된 String 값입니다.

UserName
(선택 사항) 필요한 경우 Destination에 대한 액세스 권한을 부여하는 사용자 ID를 포함하는 String 값입니다.

암호
(선택 사항) 필요한 경우 UserName을 확인하는 암호를 포함하는 String 값입니다.

옵션
(선택 사항) adCopyUnspecified의 기본값이 있는 CopyRecordOptionsEnum 값입니다. 이 메서드의 동작을 지정합니다.

비동기
(선택 사항) True인 경우 이 작업이 비동기적이어야 한다고 지정하는 부울 값입니다.

Return Value

일반적으로 Destination 값을 반환하는 String 값입니다. 그러나 반환되는 정확한 값은 공급자에 따라 다릅니다.

설명

Source 및 Destination의 값은 동일하지 않아야 합니다. 그렇지 않으면 런타임 오류가 발생합니다. 서버, 경로 또는 리소스 이름 중 하나 이상이 달라야 합니다.

adCopyNonRecursive가 지정되지 않는 한 Source의 모든 자식(예: 하위 디렉터리)은 재귀적으로 복사됩니다. 재귀 작업에서 Destination은 Source의 하위 디렉터리가 아니어야 합니다. 그렇지 않으면 작업이 완료되지 않습니다.

adCopyOverWrite를 지정하지 않는 한 Destination에서 기존 엔터티(예: 파일 또는 디렉터리)를 식별하면 이 메서드가 실패합니다.

중요

adCopyOverWrite 옵션을 신중하게 사용합니다. 예를 들어 디렉터리에 파일을 복사할 때 이 옵션을 지정하면 디렉터리가 삭제되고 해당 파일로 바뀝니다.

참고

http 체계를 사용하는 URL은 Microsoft OLE DB Provider for Internet Publishing을 자동으로 호출합니다. 자세한 내용은 절대 URL 및 상대 URL을 참조하세요.

적용 대상

레코드 개체(ADO)