CCommand::Open

아티클
02/21/2013

실행 하 고 필요에 따라 명령에 바인딩합니다.

HRESULT Open(
   const CSession& session,
   LPCWSTR wszCommand,
   DBPROPSET *pPropSet = NULL,
   DBROWCOUNT* pRowsAffected = NULL,
   REFGUID guidCommand = DBGUID_DEFAULT,
   bool bBind = true,
   ULONG ulPropSets = 0
) throw( );
HRESULT Open(
   const CSession& session,
   LPCSTR szCommand,
   DBPROPSET *pPropSet = NULL,
   DBROWCOUNT* pRowsAffected = NULL,
   REFGUID guidCommand = DBGUID_DEFAULT,
   bool bBind = true,
   ULONG ulPropSets = 0
) throw( );
HRESULT Open(
   const CSession& session,
   INT szCommand = NULL,
   DBPROPSET *pPropSet = NULL,
   DBROWCOUNT* pRowsAffected = NULL,
   REFGUID guidCommand = DBGUID_DEFAULT,
   bool bBind = true,
   ULONG ulPropSets = 0
) throw( );
HRESULT Open(
   DBPROPSET *pPropSet = NULL,
   DBROWCOUNT* pRowsAffected = NULL,
   bool bBind = true,
   ULONG ulPropSets = 0
) throw( );

매개 변수

session
[in] 세션에서 명령을 실행 합니다.
wszCommand
[in] 명령을 실행 하려면 유니코드 문자열로 전달 합니다.수 NULL 사용 하는 경우 CAccessor, 명령에 전달 된 값에서 검색 되지 경우에 DEFINE_COMMAND 매크로.참조 ICommand::Execute 에 OLE DB 프로그래머용 참조 대 한 자세한 내용은.
szCommand
[in] 동일 wszCommand 이 매개 변수는 ANSI 명령 문자열 사용을 제외 하 고.이 메서드의 네 번째 폼 NULL 값을 사용할 수 있습니다.자세한 내용은이 항목의 뒷부분에 나오는 "주의"를 참조 하십시오.
pPropSet
[in] 에 대 한 포인터의 배열 DBPROPSET 속성 및 설정 값을 포함 하는 구조체입니다.볼 속성 집합 및 속성 그룹 에 있는 OLE DB 프로그래머용 참조 에 Windows SDK.

pRowsAffected
[/ 아웃] 메모리 명령에 의해 영향을 받는 행 수가 반환 되는 위치에 대 한 포인터입니다.경우 * pRowsAffected 입니다 NULL, 없음 행 개수를 반환 합니다.그렇지 않으면 열기 설정 *pRowsAffected 다음 조건에 따라:

상태	Then
CParamSets 요소의 pParams 1 보다 큰	*pRowsAffected 실행에 지정 된 매개 변수 집합의 모든 영향을 받는 행의 총 수를 나타냅니다.
영향을 받는 행 수가 없습니다.	*pRowsAffected is set to –1.
명령은 업데이트 되지 않습니다, 삭제 또는 행을 삽입 합니다.	*pRowsAffected 는 정의 되지 않습니다.

guidCommand
[in] 명령 텍스트의 구문을 분석 구문 및 일반 규칙을 사용 하는 공급자를 지정 하는 GUID입니다.참조 ICommandText::GetCommandText 및 ICommandText::SetCommandText 에 OLE DB 프로그래머용 참조 대 한 자세한 내용은.
bBind
[in] 명령이 자동으로 실행 한 후 바인딩할 것인지 지정 합니다.기본값은 true, 명령을 자동으로 바인딩할 수 있는 발생 합니다.설정 bBind 에 false 직접 바인딩할 수 있도록 하는 명령 자동 바인딩 하는 것을 금지 합니다.(수동 바인딩은 OLAP 사용자에 게 특정 관심입니다.)
ulPropSets
[in] 수가 DBPROPSET 구조체를 전달 하는에 있는 pPropSet 인수.

반환 값

표준 HRESULT.

설명

처음 세 가지 형태의 열기 걸릴 세션, 명령, 만들고 필요에 따라 매개 변수 바인딩 명령을 실행 합니다.

첫 번째 폼의 열기 명령 하는 유니코드 문자열 및 기본 값이 없습니다.

두 번째 폼의 열기 ANSI 명령 문자열 및 기본 값 (ANSI의 기존 응용 프로그램과 이전 버전과 호환성에 대 한 제공)를 사용 합니다.

세 번째 형태의 열기 명령 문자열 형식 때문에 NULL을 사용할 수 있도록 int 기본 값이 NULL 인.이 호출에 대 한 제공 됩니다 Open(session, NULL); 또는 Open(session); NULL 형식 이므로 int.이 버전이 필요 하며 해당 어설션을 int 매개 변수는 NULL 이어야 합니다.

네 번째 양식을 사용할 열기 명령을 이미 만든 및 단일 수행 하려는 경우 준비 및 여러 실행 합니다.

[!참고]

열기 호출 Execute, 어떤 차례로 호출 GetNextResult.

다음을 통해 공유

CCommand::Open

매개 변수

반환 값

설명

요구 사항

참고 항목

참조

추가 리소스