Bagikan melalui

Mengembalikan Kode (Penyedia OLE DB Klien Asli)

  • Artikel

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

Pada tingkat paling dasar, fungsi anggota berhasil atau gagal. Pada tingkat yang agak lebih tepat, fungsi dapat berhasil, tetapi keberhasilannya mungkin bukan yang dimaksudkan pengembang aplikasi.

Untuk informasi selengkapnya tentang kode pengembalian OLE DB, lihat Mengembalikan Kode (OLE DB).

Ketika fungsi anggota penyedia SQL Server Native Client OLE DB mengembalikan S_OK, fungsi berhasil.

Ketika fungsi anggota penyedia SQL Server Native Client OLE DB tidak mengembalikan S_OK, makro OLE/COM HRESULT-unpacking FAILED dan IS_ERROR dapat menentukan keberhasilan atau kegagalan fungsi secara keseluruhan.

Jika GAGAL atau IS_ERROR mengembalikan TRUE, konsumen penyedia SQL Server Native Client OLE DB yakin bahwa eksekusi fungsi anggota gagal. Ketika FAILED atau IS_ERROR mengembalikan FALSE dan HRESULT tidak sama dengan S_OK, konsumen penyedia SQL Server Native Client OLE DB yakin bahwa fungsi berhasil dalam beberapa hal. Konsumen dapat mengambil informasi terperinci tentang pengembalian "keberhasilan dengan informasi" ini dari antarmuka kesalahan penyedia SQL Server Native Client OLE DB. Selain itu, dalam kasus di mana fungsi gagal dengan jelas (makro YANG GAGAL mengembalikan TRUE), informasi kesalahan yang diperluas tersedia dari antarmuka kesalahan penyedia SQL Server Native Client OLE DB.

Konsumen penyedia SQL Server Native Client OLE DB biasanya menemukan DB_S_ERRORSOCCURRED "keberhasilan dengan informasi" pengembalian HRESULT. Biasanya, fungsi anggota yang mengembalikan DB_S_ERRORSOCCURRED menentukan satu atau beberapa parameter yang memberikan nilai status kepada konsumen. Tidak ada informasi kesalahan yang mungkin tersedia untuk konsumen selain yang dikembalikan dalam parameter nilai status, sehingga konsumen harus menerapkan logika aplikasi untuk mengambil nilai status saat tersedia.

Fungsi anggota penyedia SQL Server Native Client OLE DB tidak mengembalikan kode keberhasilan S_FALSE. Semua fungsi anggota penyedia SQL Server Native Client OLE DB selalu mengembalikan S_OK untuk menunjukkan keberhasilan.

Lihat Juga

Kesalahan