次の方法で共有

CCommand::Open

  • [アーティクル]

実行はオプションでコマンドをバインドします。

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 文字列として渡されます。コマンドが DEFINE_COMMAND のマクロに渡された値から取得されている場合 CAccessorを使用すると NULL はなることがあります。詳細については、 " OLE DB Programmer's Reference " のICommand::Execute を参照してください。

  • szCommand
    [in] wszCommand が、このパラメーターと同様に ANSI のコマンド文字列が使用されます。このメソッドの 4 番目の形式は NULL 値を受け取ることができます。詳細については、このトピックの 「解説」を参照してください。

  • pPropSet
    [in] 設定されるプロパティと値を含む DBPROPSET の構造体の配列へのポインター。Windows SDKOLE DB Programmer's Reference " の プロパティとプロパティ グループ を参照してください。

  • pRowsAffected
    [in/out] コマンドの影響を受ける行の数がを返すメモリへのポインター。*pRowsAffectedNULLは、行数を返します。それ以外 開く(&&O),開く,[開く] は、次の条件に従って *pRowsAffected を設定します:

    If

    Then

    pParams の大きい 1 の cParamSets の要素

    *pRowsAffected は、で指定されたパラメーター設定を受けるすべての合計数を表します。

    影響を受ける行の数は利用できません。

    * –pRowsAffected は 1 に設定されます。

    コマンドは、行を更新したり、削除したり、挿入されません

    *pRowsAffected は未定義です。

  • guidCommand
    [in] プロバイダーのコマンド テキストの解析に使用する構文と一般的な規則を指定する GUID。詳細については、 " OLE DB Programmer's Reference " のICommandText::GetCommandText と ICommandText::SetCommandText を参照してください。

  • bBind
    [in] の実行後にコマンドを自動的にバインドするかどうかを指定します。自動的にバインドされたコマンドが発生 TRUE既定値はです。手動でバインドできるように false に設定 bBind は、コマンドの自動バインディングを防ぎます。（手動バインディングは、 OLAP のユーザーにとって重要な問題です）。

  • ulPropSets
    [in] pPropSet の 引数で渡される DBPROPSET の構造の数。

戻り値

標準の HRESULT を返します。

解説

開く(&&O),開く,[開く] の最初の 3 とおりの形式はセッションを受け取り、コマンドを作成し、必要に応じてパラメーターをバインドするコマンドを実行します。

開く(&&O),開く,[開く] の最初の形式は、 Unicode のコマンド文字列を受け取り、既定値はありません。

開く(&&O),開く,[開く] の 2 番目の形式は ANSI のコマンド文字列と既定値を受け取りません （ANSI あるアプリケーションとの下位互換性に付属）。

開く(&&O),開く,[開く] の 3 番目の形式はコマンド文字列が null の既定値を持つ型 int に、 null になるようにします。これは Open(session, NULL); か Open(session); を呼び出す場合は、 NULL が型であるため int提供されます。このバージョンはを使用し、 int パラメーターが null であることを表しています。

既にコマンドを作成する場合は、単一の 準備 および複数の実行を実行する 開く(&&O),開く,[開く] の 4 番目の形式を使用します。

[!メモ]

開く(&&O),開く,[開く] は 実行をダイヤルして、を GetNextResultをダイヤルする。

必要条件

ヘッダー: atldbcli.h

参照

関連項目

CCommand クラス