CCommand::Open
Ejecuta y enlaza opcionalmente el 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( );
Parámetros
session
[in] La sesión en la que se ejecuta el comando.wszCommand
[in] El comando para ejecutarse, pasado como cadena Unicode. Puede ser nulo al utilizar CAccessor, en este caso recuperar el comando del valor pasado a la macro de DEFINE_COMMAND . Vea ICommand::Execute en la referencia del programador para obtener detalles.szCommand
[in] Igual que wszCommand salvo que este parámetro toma una cadena de comando ANSI. El cuarto formulario de este método puede tomar un valor nulo. Vea “notas” más adelante en este tema para obtener detalles.pPropSet
[in] Un puntero a una matriz de estructuras de DBPROPSET que contienen las propiedades y los valores que se establecerán. Vea Conjuntos de propiedades y grupos de propiedades en la referencia del programador de OLE Windows SDK.pRowsAffected
[in/out] Un puntero a la memoria donde el recuento de filas afectadas por un comando se devuelve. Si se *pRowsAffected es cambia nulo, ningún recuento de filas. Si no, conjuntos de Abierta *pRowsAffected según las condiciones siguientes:Si
Entonces...
El elemento de cParamSets de pParams es mayor que 1
*pRowsAffected representa el número total de filas afectadas por todos los conjuntos de parámetros especificados en la ejecución.
El número de filas afectadas no está disponible
*pRowsAffected se establece – 1.
El comando no actualiza, eliminar, ni inserta filas
*pRowsAffected es indefinido.
guidCommand
[in] GUID que especifica la sintaxis y las reglas generales para que el proveedor usa de analizar el texto de comando. Vea ICommandText::GetCommandText y ICommandText::SetCommandText en la referencia del programador para obtener detalles.bBind
[in] Especifica si enlazar el comando automáticamente después de ejecutarse. El valor predeterminado es true, que hace que el comando de enlazarse automáticamente. El valor bBind a false evita el enlace automático del comando para que pueda enlazar manualmente. (El enlace manual resulta especialmente interesante para los usuarios de OLAP).ulPropSets
[in] El número de estructuras de DBPROPSET pasadas en el argumento de pPropSet .
Valor devuelto
HRESULTestándar.
Comentarios
Los primeros tres formas de Abierta toman una sesión, crean un comando, y ejecuta el comando, enlazar cualquier parámetro según sea necesario.
El primer formulario de Abierta toma una cadena de comando Unicode y no tiene ningún valor predeterminado.
El segundo formato de Abierta toma una cadena de comando ANSI y ningún valor predeterminado (proporcionados por compatibilidad con versiones anteriores las aplicaciones existentes de ANSI).
El tercer formulario de Abierta permite que la cadena de comando sea NULL, debido a int escrito con un valor predeterminado de NULL. Se proporciona para llamar a Open(session, NULL); o Open(session); porque NULL es de intescrito. Esta versión requiere y afirma que el parámetro de int sea NULL.
Utilice el cuarto formulario de Abierta cuando haya creado un comando y desea realizar solo Preparación y ejecuciones.
Nota
Abierta llama Ejecución, que a su vez llama a GetNextResult.
Requisitos
Encabezado: atldbcli.h