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] sesión del para ejecutar el comando.wszCommand
[in] el comando para ejecutarse, pasado como cadena Unicode.Puede ser NULL 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] Same 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] 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 NULL, ningún recuento de filas.Si no, conjuntos de Abrir *pRowsAffected según las condiciones siguientes:If
Then
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] número de estructuras de DBPROPSET pasadas en el argumento de pPropSet .
Valor devuelto
HRESULTestándar.
Comentarios
Los primeros tres formas de Abrir toman una sesión, crean un comando, y ejecuta el comando, enlazar cualquier parámetro según sea necesario.
El primer formulario de Abrir toma una cadena de comando Unicode y no tiene ningún valor predeterminado.
El segundo formato de Abrir 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 Abrir 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 Abrir cuando haya creado un comando y desea realizar solo Preparación y ejecuciones.
[!NOTA]
Abrir llama Execute, que a su vez llama a GetNextResult.
Requisitos
Header: atldbcli.h