使用 SQLBulkOperations 插入資料類似於使用 SQLBulkOperations 更新資料,因為它使用了綁定應用程式緩衝區的資料。
為了讓新列中的每一欄都有值,所有長度/指示值為 SQL_COLUMN_IGNORE 的綁定欄位和所有未綁定欄位必須接受 NULL 值或設定預設值。
要插入 SQLBulkOperations 的資料列,應用程式會執行以下操作:
將 SQL_ATTR_ROW_ARRAY_SIZE 陳述句屬性設定為要插入的列數,並將新資料值置於綁定的應用程式緩衝區中。 關於如何用 SQLBulkOperations 傳送長資料的資訊,請參見 Long Data 與 SQLSetPos 及 SQLBulkOperations。
根據需要設定每欄長度/指示緩衝區的值。 這是綁定到字串緩衝區的欄位的資料位元組長度或 SQL_NTS,綁定到二進位緩衝區的欄位的資料位元組長度,對於任何要設定為 NULL 的欄位則為 SQL_NULL_DATA。 應用程式會將指定為設置為其預設值(若存在)或 NULL(若不存在)之欄位的長度/指示緩衝區值設為 SQL_COLUMN_IGNORE。
呼叫 SQLBulkOperations ,並將 Operation 參數設為 SQL_ADD。
SQLBulkOperations 回傳後,目前的列保持不變。 若書籤欄位(第 0 欄)被綁定, SQLBulkOperations 會回傳綁定該欄位的列集緩衝區中插入的書籤。