IBCPSession::BCPColumns (OLE DB)

Establece el número de campos que se van a enlazar a las columnas de una tabla de SQL Server.

Sintaxis

  
HRESULT BCPColumns(   
DBCOUNTITEMnColumns);  

Observaciones

Internamente llama a IBCPSession::BCPColFmt para establecer los valores predeterminados para los datos de campo. Estos valores predeterminados se obtienen de la información de columna de SQL Server que el proveedor recupera internamente cuando se especifica el nombre de la tabla a través de IBCPSession::BCPInit.

Solo debe llamar a este método si piensa usar un formato de archivo de usuario que difiere del valor predeterminado. Para obtener más información sobre una descripción del formato de archivo de usuario predeterminado, vea el método BCPInit .

Después de llamar al método BCPColumns , debe llamar al método BCPColFmt para cada columna del archivo de usuario para definir completamente un formato de archivo personalizado.

Argumentos

nColumns[in]
Número total de campos del archivo de usuario. Incluso si va a preparar la copia masiva de datos del archivo de usuario en una tabla de SQL Server y no pretende copiar todos los campos del archivo de usuario, debe establecer el argumento nColumns en el número total de campos de archivo de usuario. Los campos omitidos se pueden especificar a través de BCPColFmt.

Valores de código de retorno

S_OK
El método se ha llevado a cabo de forma correcta.

E_FAIL
Error específico del proveedor; para obtener información detallada, use la interfaz ISQLServerErrorInfo .

Error_Inesperado
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 cuando se llama a este método más de una vez para una operación de copia masiva.

E_MEMORIA_INSUFICIENTE
Error de memoria insuficiente.

Véase también

IBCPSession (OLE DB)
Realización de operaciones de copia masiva