IBCPSession::BCPWriteFmt (OLE DB)

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

Sintaxis

HRESULT BCPWriteFmt( 
      const wchar_t *pwszFormatFile);

Comentarios

El archivo de formato especifica el formato de los datos de un archivo de datos creado mediante copia masiva. Las llamadas a los métodos IBCPSession::BCPColumns e IBCPSession::BCPColFmt definen el formato del archivo de datos. El método BCPWriteFmt guarda esta definición en el archivo al que se hace referencia en el argumento pwszFormatFile.

El método BCPWriteFmt puede guardar los archivos de formato en formato xml o de texto. Esto se debe indicar utilizando la opción de control BCP_OPTION_XML con el método IBCPSession::BCPControl.

Para cargar un archivo de formato guardado, utilice el método IBCPSession::BCPReadFmt.

Nota

Las versiones de la utilidad bcp distribuidas con SQL Server versión 7.0 o posteriores admiten sólo el archivo de formato generado por el método BCPWriteFmt.

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

Otros recursos