IRowsetFastLoad::InsertRow (OLE DB)
Umożliwia dodanie wiersza do zestawu zestaw wierszy kopiowanie masowe.
HRESULT InsertRow(
HACCESSOR hAccessor,
void* pData);
Argumenty
hAccessor[w]
Dojście akcesora, definiowanie do zbiorczego kopiowania danych wiersza.Metoda dostępu, do którego odwołuje się to akcesor wiersza, wią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 Struktury DBBINDING.
Wartości kodów powrotnych
S_OK
metoda powiodło się.Wszystkie wartości stanu powiązania dla wszystkich kolumn mieć wartość DBSTATUS_S_OK lub DBSTATUS_S_NULL.E_FAIL
Wystąpił błąd.Informacje o błędzie jest dostępna z interfejsów błąd ten zestaw wierszy.E_INVALIDARG
The pData argument was zestaw to a pusty wskaźnik.E_OUTOFMEMORY
SQLNCLI10 nie może przydzielić wystarczającej ilości pamięci do wykonania żądania.E_UNEXPECTED
Metoda została wywołana w zestawie zestaw wierszy zbiorczej kopii wcześniej unieważnione przez IRowsetFastLoad::zatwierdzanie metody.DB_E_BADACCESSORHANDLE
The hAccessor argument provided by the consumer was invalid.DB_E_BADACCESSORTYPE
Określony metoda dostępu nie była metoda dostępu wiersza lub nie określono pamięci należących do konsumenta.
Remarks
Błąd podczas konwertowania danych klient na SQL Server Typ danych dla kolumna powoduje, że E_FAIL zwrotu z SQL Server Macierzystego dostawca klient OLE DB. Dane mogą być przekazywane do SQL Server w przypadku dowolnego InsertRow metoda lub tylko na zatwierdzanie metoda.Aplikacja klienta może wywołać InsertRow istnieje metoda tyle razy, przy użyciu błędnych danych przed odbiera powiadomienie, że danych typu Błąd konwersji. Ponieważ zatwierdzanie metoda gwarantuje, że wszystkie dane jest poprawnie określony przez konsumenta, konsument może używać zatwierdzanie metody odpowiednio do sprawdzania poprawności danych w razie potrzeby.
The SQL Server Native klient OLE DB dostawca kopiowanie masowe rowsets are write-only. The SQL Server Native klient OLE DB dostawca exposes no methods allowing consumer query of the zestaw wierszy. Do zakończenia przetwarzania, konsument może zwolnić odwołanie na IRowsetFastLoad interfejs bez wywoływania zatwierdzanie metoda.Nie ma żadnych urządzeń do dostęp do wiersza dodaje konsumenta w zestawie zestaw wierszy i zmieniając jej wartości lub indywidualnie usuwając ją z zestawu zestaw wierszy.
Skopiowane wiersze zbiorczego są formatowane na serwerze SQL Server. Format wiersza jest narażony na wszystkie opcje, które mogły zostać zestaw połączenia lub sesja, takie jak ANSI_PADDING.Ta opcja jest ustawiona na domyślnie dla dowolnego połączenia dokonanych przy użyciu SQL Server Macierzystego dostawca klient OLE DB.