IRowsetFastLoad::InsertRow (OLE DB)
Dodaje wiersz do kopiowanie masowe zestawu zestaw wierszy.
Składnia
HRESULT InsertRow(
HACCESSOR hAccessor,
void* pData);
Argumenty
hAccessor[w]
Uchwyt metoda dostępu Definiowanie wiersz danych kopiowanie masowe.metoda dostępu odwołanie jest metoda dostępu wiersza, powiązanie pamięci posiadane przez konsumenta, zawierające wartości danych.pData[w]
Wskaźnik do pamięci posiadane przez konsumenta, zawierające wartości danych.Aby uzyskać więcej informacji, zobacz DBBINDING struktury.
Wartości kodów powrotnych
S_OK
metoda powiodło się.Wszystkie wartości stanu związany dla wszystkich kolumn ma wartość DBSTATUS_S_OK lub DBSTATUS_S_NULL.E_FAIL
Wystąpił błąd.Informacje o błędzie są dostępne z interfejsów błąd w zestawie zestaw wierszy.E_INVALIDARG
PData argument był zestaw na wskaźnik NULL.BŁĄD E_OUTOFMEMORY
SQLNCLI10 nie może przydzielić wystarczającej ilości pamięci do wykonania żądania.E_UNEXPECTED
W wywołaniu metoda na zestaw wierszy kopiowanie masowe wcześniej unieważnione przez IRowsetFastLoad::Commit metoda.DB_E_BADACCESSORHANDLE
HAccessor dostarczonych przez konsumenta argument był nieprawidłowy.DB_E_BADACCESSORTYPE
Określony metoda dostępu nie był metoda dostępu wiersza lub nie określono pamięci posiadane przez konsumenta.
Uwagi
Błąd podczas konwertowania danych konsumentów do SQL Server Typ danych kolumna powoduje E_FAIL zwrotu z SQL Server macierzystego klienta OLE DB dostawca.Dane mogą być przesyłane do SQL Server na dowolnej InsertRow metoda lub tylko na Commit metoda.Aplikacja konsument może wywołać InsertRow metoda wiele razy z błędnych danych przed otrzymuje powiadomienie, że istnieje błąd konwersji typu danych.Ponieważ Commit metoda daje pewność, że wszystkie dane jest poprawnie określony przez konsumenta, można użyć konsumenta Commit metody odpowiednio do sprawdzania poprawności danych w razie potrzeby.
SQL Server Macierzystego klienta dostawca OLE DB kopiowanie masowe zestawów wierszy są tylko do zapisu. SQL Server Macierzystego klienta dostawca OLE DB udostępnia metody, nie pozwalając kwerendy konsumenta z zestawu zestaw wierszy.Zakończenie przetwarzania, konsumenta można zwolnić odwołanie na IRowsetFastLoad interfejs bez telefonicznej Commit metoda.Ma dostęp do wiersza dodaje konsumenta w zestawie zestaw wierszy i zmieniając jej wartości lub usunięciem indywidualnie z zestawu zestaw wierszy.
Skopiowane wiersze zbiorczego są formatowane na serwerze SQL Server.Format wiersz dotyczy wszelkie opcje, które mogły być zestaw połączenia lub sesja, takie jak spowodowałyby.Opcja ta jest zestaw na domyślnie dla dowolnego połączenia ustanawianego przez SQL Server macierzystego klienta OLE DB dostawca.