HRESULT Open (DBPROPSET *pPropSet = NULL, LONG * pRowsAffected = NULL, bool blegate = true);
HRESULT Open (const CSessionamp;sessioneLPCTSTRszCommand= NULL, DBPROPSET *pPropSet= NULL, LONG *pRows&Affected= NULL, REFGUIDguidCommand= DBGUID_DEFAULT, boolblegate = true );
Valore restituito
Un standard HRESULT.
Parametri
pPropSet
[in e out] Una matrice di DBPROPSET strutture contenenti le proprietà e i valori da impostare. Le proprietà specificate in queste strutture devono appartenere al gruppo di proprietà del set di righe.
pRowsAffected
[in e out] Un puntatore alla memoria dove viene restituito il numero di righe interessate da un comando. Se * pRowsAffected è NULL, non viene restituito alcun conteggio delle righe. In caso contrario, Open imposta *pRowsAffected alle seguenti condizioni:
| Se | Poi |
| L'elemento cParamSets del pParams è maggiore di 1 | pRowsAffected rappresenta il numero totale di righe interessate da tutti i set di parametri specificati nell'esecuzione. |
| Il numero di righe non è disponibile | pRowsAffected è impostata su – 1. |
| Il comando non aggiorna, eliminare o inserire righe | pRowsAffected non è definito. |
blegate
[in] True se il comando è associato dopo essere giustiziato. In caso contrario, false.
sessione
[in] La sessione in cui eseguire il comando.
szCommand
[in] Il comando da eseguire. Può essere NULL quando si utilizza CAccessor, nel quale caso che il comando verrà recuperato dal valore passato alla macro DEFINE_COMMAND . Vedi ICommand:: Execute in OLE DB Programmer di riferimento per i dettagli.
guidCommand
[in] Un GUID che specifica la sintassi e le regole generali per il provider da utilizzare durante l'analisi del testo del comando. Vedi ICommandText::GetCommandText e ICommandText:: SetCommandText in OLE DB Programmer di riferimento per i dettagli.
Osservazioni
Utilizzare la prima versione di questo metodo quando un comando è già stato creato e si desidera eseguire una singola Prepare e più esecuzioni. La seconda versione del metodo prende una sessione, crea un comando e viene eseguito il comando, associazione tutti i parametri necessari.