CCommand::Open

發行項
02/28/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]若要執行，命令傳遞做為 Unicode 字串。可能是 NULL 時使用CAccessor，在此情況下] 命令將會從傳遞至值擷取 DEFINE_COMMAND 巨集。請參閱 ICommand::Execute 在 OLE DB 程式設計人員參考如需詳細資訊。
szCommand
[in]相同的wszCommand不同之處在於這個參數會使用 ANSI 命令字串。這個方法的第四個表單可以採取 NULL 值。稍後在本主題，如需詳細資訊，請參閱「備註」。
pPropSet
[in]變數的指標陣列， DBPROPSET 結構，其中包含屬性和設定值。請參閱的屬性集和屬性群組在 OLE DB 程式設計人員參考》 在Windows SDK。

pRowsAffected
[/ 輸出]命令所影響的資料列計數就會傳回其中的記憶體指標。如果 1 pRowsAffected 是 NULL，則會傳回任何資料列計數。否則，開啟設定 1pRowsAffected根據下列條件來：

如果	Then
CParamSets 中的項目pParams大於 1	1pRowsAffected代表受到所有執行中所指定的參數集的資料列總數。
沒有可用的受影響的資料列數目	*pRowsAffected is set to –1.
命令不會更新、刪除或插入資料列	1pRowsAffected尚未定義。

guidCommand
[in]剖析命令文字中指定的語法和一般的規則，若要使用的提供者的 GUID。請參閱 ICommandText::GetCommandText 和 ICommandText::SetCommandText 在 OLE DB 程式設計人員參考如需詳細資訊。
bBind
[in]指定是否要自動繫結] 指令之後執行。預設值是 ，則為 true，這會導致指令會自動繫結。設定bBind到 ，則為 false 防止自動結合該命令，讓您以手動方式可以繫結。 (手動繫結是興趣的特定使用者 OLAP)。
ulPropSets
[in]數目 DBPROPSET 結構傳入的 pPropSet 引數。

傳回值

一種標準HRESULT。

備註

第一次的三種形式的開啟工作階段，建立一個指令，並執行命令，繫結所需的任何參數。

第一種形式的開啟接受 Unicode 命令字串，並沒有預設值。

第二種開啟所需的 ANSI 命令字串和 (提供與現有的 ANSI 應用程式的回溯相容性) 沒有預設值。

第三種開啟可讓命令字串為 NULL，因為型別int預設值為 NULL。它提供給電話Open(session, NULL);或Open(session);因為 NULL 的型別，所以int。這個版本的要求，並判斷提示的int參數是 NULL。

使用第四種形式的開啟當您已經建立一個命令，而您想要執行一個備製和多個執行次數。

注意事項
開啟呼叫 Execute，它會呼叫GetNextResult。

共用方式為

CCommand::Open

參數

傳回值

備註

需求

請參閱

參考

其他資源