Execute 메서드(RDS)
요청을 실행하고 ADO 2.5 이상에서 사용할 ADO 레코드 집합을 만듭니다.
중요
Windows 8 및 Windows Server 2012부터, RDS 서버 구성 요소는 더 이상 Windows 운영 체제에 포함되지 않습니다(자세한 내용은 Windows 8 및 Windows Server 2012 호환성 쿡북 참조). RDS 클라이언트 구성 요소는 이후 버전의 Windows에서 제거될 예정입니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. RDS를 사용하는 애플리케이션은 WCF Data Service로 마이그레이션해야 합니다.
구문
object.Execute(ConnectionString As String, HandlerString As String, QueryString As String, lFetchOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters, [lcid As Long], [pInformation])
매개 변수
ConnectionString
실행을 위해 요청을 보낼 OLE DB 공급자에 연결하는 데 사용되는 문자열입니다. HandlerString을 사용하여 처리기를 지정한 경우 연결 문자열을 편집하거나 바꿀 수 있습니다.
HandlerString
이 실행에 사용할 처리기를 식별하는 두 부분으로 구성된 문자열입니다. 문자열에는 두 부분이 포함됩니다. 첫 번째 부분은 사용할 처리기의 이름(ProgID)을 포함합니다. 두 번째 부분은 처리기에 전달할 인수를 포함합니다. 인수 문자열을 해석하는 방법에 대한 세부 정보는 각 처리기에 따라 다릅니다. 두 부분은 문자열에서 쉼표의 첫 번째 인스턴스로 구분됩니다. 인수 문자열에는 추가 쉼표가 포함될 수 있습니다. 인수는 선택 사항입니다.
QueryString
연결 문자열에서 식별된 OLE DB 공급자가 지원하는 명령 언어의 명령입니다. SQL 기반 공급자의 경우 QueryString에 Transact-SQL 명령문이 포함될 수 있지만 비 SQL 공급자(예: MSDataShape)의 경우 Transact-SQL 쿼리 문이 아닐 수 있습니다.
처리기를 사용하는 경우 처리기는 여기에 지정된 값을 변경하거나 바꿀 수 있습니다. 예를 들어 처리기는 일반적으로 QueryString을 .ini 파일의 쿼리 문자열로 바꿉니다. 기본적으로 Msdfmap.ini 파일이 사용됩니다.
lFetchOptions
비동기 페치 유형을 나타냅니다.
자세한 내용은 FetchOptions 속성(RDS)을 참조하세요.
TableID
VT_EMPTY 또는 VT_BSTR 형식의 Variant입니다. 이 값이 VT_EMPTY 형식인 경우 무시됩니다. VT_BSTR 형식인 경우 adCmdTableDirect를 사용하여 레코드 집합이 생성되고 여기에 지정된 값이 생성되고 QueryString 매개 변수는 무시됩니다.
lExecuteOptions
실행 옵션의 비트 마스크:
1=ReadOnly 레코드 집합은 adLockReadOnly를 사용하여 열립니다.
2=NoBatch 레코드 집합은 adLockOptimistic을 사용하여 열립니다.
4=AllParamInfoSupplied 호출자는 모든 매개 변수에 대한 매개 변수 정보가 pParameters에 제공되도록 보장합니다.
8=GetInfo 쿼리에 대한 매개 변수 정보는 OLE DB 공급자에서 가져오고 pParameters 매개 변수에 반환됩니다. 쿼리가 실행되지 않고 레코드 집합이 반환되지 않습니다.
16=GetHiddenColumnsadLockBatchOptimistic을 사용하여 레코드 집합이 열리고 숨겨진 열이 레코드 집합에 포함됩니다.
ReadOnly, NoBatch, GetHiddenColumns는 상호 배타적인 옵션입니다. 그러나 둘 이상을 설정해도 오류가 발생하지 않습니다. 여러 옵션이 설정된 경우 GetHiddenColumns가 다른 모든 옵션보다 우선적으로 적용되고 ReadOnly가 그 뒤를 잇습니다. 옵션을 지정하지 않으면 기본적으로 adLockBatchOptimistic을 사용하여 레코드 집합이 열리고 숨겨진 열은 레코드 집합에 포함되지 않습니다.
pParameters
매개 변수 정의의 안전한 배열을 포함하는 Variant입니다. GetInfo 옵션이 lExecuteOptions에 지정된 경우 이 매개 변수는 OLE DB 공급자로부터 가져온 매개 변수 정의를 반환하는 데 사용됩니다. 그렇지 않으면 이 매개 변수가 비어 있을 수 있습니다.
lcid
pInformation에서 반환되는 오류를 빌드하는 데 사용되는 LCID입니다.
pInformation
Execute에서 반환한 정보 오류에 대한 포인터입니다. NULL이면 오류 정보가 반환되지 않습니다.
설명
HandlerString 매개 변수는 null일 수 있습니다. 이 경우 발생하는 작업은 RDS 서버가 구성된 방식에 따라 달라집니다. “MSDFMAP.handler”의 처리기 문자열은 Microsoft 제공 처리기(Msdfmap.dll)를 사용해야 함을 나타냅니다. “MASDFMAP.handler,sample.ini”의 처리기 문자열은 Msdfmap.dll 처리기를 사용해야 하며 “sample.ini” 인수를 처리기에 전달해야 함을 나타냅니다. MSDFMAP.dll은 sample.ini를 사용하여 연결 및 쿼리 문자열을 확인하는 방향으로 인수를 해석합니다.