Compartir a través de


IBCPSession::BCPExec (OLE DB)

Realiza la operación de copia masiva.

Sintaxis

HRESULT BCPExec( 
      DBROWCOUNT *pRowsCopied);

Comentarios

El método BCPExec copia los datos de un archivo de usuario en una tabla de base de datos o viceversa, en función del valor del parámetro eDirection utilizado con el método IBCPSession::BCPInit.

Antes de llamar a BCPExec, llame al método BCPInit con un nombre de archivo de usuario válido. Si no lo hace, se producirá un error. La única excepción es que una consulta vaya a utilizarse para una operación de salida de copia masiva. En ese caso, especifique NULL para el nombre de tabla en el método BCPInit y, a continuación, especifique la consulta mediante la opción BCP_OPTION_HINTS.

El método BCPExec es el único método de copia masiva que es probable que quede pendiente durante un período de tiempo indeterminado. Por lo tanto, es el único método de copia masiva que admite el modo asincrónico. Para usar el modo asincrónico, establezca la propiedad de sesión SSPROP_ASYNCH_BULKCOPY específica del proveedor en VARIANT_TRUE antes de llamar al método BCPExec. Esta propiedad se encuentra disponible en el conjunto de propiedades DBPROPSET_SQLSERVERSESSION. Para comprobar si se ha completado, llame al método BCPExec con los mismos parámetros. Si la copia masiva aún no se ha completado, el método BCPExec devuelve DB_S_ASYNCHRONOUS. También devuelve en el argumento pRowsCopied un recuento de estado del número de filas que se han enviado al servidor o que se han recibido del servidor. Las filas enviadas al servidor no se confirman hasta que se alcanza el final de un lote.

Argumentos

  • pRowsCopied[out]
    Puntero a un valor de tipo DWORD. El método BCPExec rellena el valor DWORD con el número de filas que se han copiado correctamente. Si el argumento pRowsCopied está establecido en NULL, el método BCPExec lo omite.

Valores de código de retorno

  • S_OK
    El método se ejecutó correctamente.

  • E_FAIL
    Se produjo un error específico del proveedor; para obtener información detallada, use la interfaz ISQLServerErrorInfo.

  • E_UNEXPECTED
    No se esperaba la llamada al método. Por ejemplo, no se llamó al método BCPInit antes de llamar a este método. También se produce si la operación se anuló mediante el uso de la opción BCP_OPTION_ABORT y después se llamó al método BCPExec.

  • E_OUTOFMEMORY
    Error de memoria insuficiente.

  • DB_S_ENDOFROWSET
    La operación de copia masiva finalizó y se completó toda la operación de transferencia de datos.

  • DB_S_ASYNCHRONOUS
    Se copió el lote actual de filas. Vuelva a llamar al método BCPExec para transferir el siguiente lote.

  • DB_S_ERRORSOCCURRED
    Se produjeron errores durante la operación de copia masiva y algunas filas no pudieron copiarse. El número de errores sigue siendo menor al número máximo de errores permitidos.

Vea también

Conceptos

Otros recursos