Compartir a través de


IBCPSession::BCPReadFmt (OLE DB)

Lee la información de formato de cada columna en el archivo de formato.

Sintaxis

HRESULT BCPReadFmt( 
      const wchar_t *pwszFormatFile);

Comentarios

El método BCPReadFmt se utiliza para leer datos de un archivo de formato que especifica el formato de datos en el archivo de datos. Este método es capaz de detectar la versión correcta del archivo de formato. Puede detectar automáticamente si el archivo de formato está en xml o en el formato de texto de estilo anterior y se comporta en consecuencia. Las versiones del archivo de formato admitidas por el proveedor OLE DB de SQL Server Native Client BCP son la 6.0 o más reciente.

Después de que el método BCPReadFmt lee los valores de formato, realiza las llamadas adecuadas a los métodos IBCPSession::BCPColumns y IBCPSession::BCPColFmt. No es necesario que analice un archivo de formato y realice estas llamadas.

Para guardar un archivo de formato, llame al método IBCPSession::BCPWriteFmt. Las llamadas al método BCPReadFmt pueden hacer referencia a formatos guardados. Como alternativa, la utilidad de copia masiva (bcp) puede guardar formatos de datos definidos por el usuario en archivos a los que puede hacer referencia el método BCPReadFmt.

El valor BCP_OPTION_DELAYREADFMT del parámetro eOption de IBCPSession::BCPControl modifica el comportamiento de IBCPSession::BCPReadFmt.

Argumentos

  • pwszFormatFile[in]
    La ruta de acceso y nombre del archivo que contiene los valores de formato para el archivo de datos.

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_OUTOFMEMORY
    Error de memoria insuficiente.

  • E_UNEXPECTED
    No se esperaba la llamada al método. Por ejemplo, no se llamó al método IBCPSession::BCPInit antes de llamar a este método.

Vea también

Conceptos

Realizar operaciones de copia masiva

Otros recursos

IBCPSession (OLE DB)