CCommand::Open
Esegue e facoltativamente associa il comando.
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( );
Parametri
session
[in] la sessione in cui eseguire il comando.wszCommand
[in] il comando da eseguire, passato come stringhe Unicode.Può essere NULL quando si utilizza CAccessor, nel qual caso il comando sarà recuperato dal valore passato alla macro di DEFINE_COMMAND .Vedere ICommand::Execute in OLE DB Programmer's Reference per i dettagli.szCommand
[in] stesso di wszCommand con la differenza che di questo parametro accetta una stringa di comando ANSI.Il quarto form di questo metodo accetta un valore null.Vedere più avanti “commenti„ in questo argomento per i dettagli.pPropSet
[in] puntatore A una matrice di strutture di DBPROPSET che contengono le proprietà e i valori da impostare.Vedere insiemi di proprietà e gruppi di proprietà in OLE DB Programmer's Reference inWindows SDK.pRowsAffected
[In/out] un puntatore alla memoria in cui il numero di righe interessate da un comando viene restituito.Se *pRowsAffected è NULL, nessun numero di righe viene restituito.In caso contrario, set di Apri *pRowsAffected a seconda delle condizioni seguenti:If
Then
L'elemento di cParamSets di pParams è maggiore di 1
*pRowsAffected rappresenta il numero complessivo di righe interessate da qualsiasi set di parametri specificati nell'esecuzione.
Il numero di righe interessate non è disponibile
*pRowsAffected viene impostato a 1.
Il comando non aggiorna, non viene eliminato, altrimenti inserite righe
*pRowsAffected è definito.
guidCommand
[in] A GUID che specifica la sintassi e le regole generali per il provider utilizza durante l'analisi del testo del comando.Vedere ICommandText::GetCommandText e ICommandText::SetCommandText in OLE DB Programmer's Reference per i dettagli.bBind
[in] specifica se associare il comando automaticamente dopo essere stato eseguito.L'impostazione predefinita è true, che causa il comando essere associato automaticamente.L'impostazione bBind a false impedisce l'associazione automatica del comando in modo da poter associare a esso le manualmente.(L'associazione manuale è di particolare interesse per gli utenti di OLAP.)ulPropSets
[in] numero di strutture di DBPROPSET passate nell'argomento del pPropSet .
Valore restituito
HRESULTstandard.
Note
I primi tre forme di Apri accettano una sessione, creare un comando ed eseguire il comando, l'associazione a seconda delle esigenze tutti i parametri.
Il primo form di Apri accetta una stringa di comando Unicode e non ha un valore predefinito.
La seconda forma di Apri non accetta una stringa di comando e ANSI valore predefinito (forniti per compatibilità con le versioni precedenti di applicazioni esistenti ANSI).
Il terzo form di Apri consente della stringa di comando è NULL, a causa di tipo int con un valore predefinito sarà NULL.Viene fornito per chiamare Open(session, NULL); o Open(session); perché NULL è di tipo int.Questa versione richiede e asserisce che il parametro di int NULL.
Utilizzare il quarto form di Apri quando è già stato creato un comando e si desidera eseguire solo preparare e più esecuzioni.
[!NOTA]
Apri chiama Execute, che a sua volta chiama GetNextResult.
Requisiti
Header: atldbcli.h