struktur SP_REGISTER_CONTROL_STATUSA (setupapi.h)

Struktur SP_REGISTER_CONTROL_STATUS berisi informasi tentang file yang didaftarkan atau tidak terdaftar menggunakan RegisterDlls direktif INF untuk mendaftarkan DLL sendiri di Windows 2000.

Saat SetupInstallFromInfSection mengirim pemberitahuan SPFILENOTIFY_STARTREGISTRATION atau SPFILENOTIFY_ENDREGISTRATION ke rutinitas panggilan balik, pemanggil harus menyediakan penunjuk ke struktur SP_REGISTER_CONTROL_STATUS dalam parameter MsgHandler .

Sintaksis

typedef struct _SP_REGISTER_CONTROL_STATUSA {
  DWORD cbSize;
  PCSTR FileName;
  DWORD Win32Error;
  DWORD FailureCode;
} SP_REGISTER_CONTROL_STATUSA, *PSP_REGISTER_CONTROL_STATUSA;

Anggota

cbSize

FileName

Jalur file yang sepenuhnya memenuhi syarat sedang didaftarkan atau tidak terdaftar.

Win32Error

Untuk pemberitahuan SPFILENOTIFY_STARTREGISTRATION, anggota ini tidak digunakan dan harus diatur ke NO_ERROR. Untuk pemberitahuan SPFILENOTIFY_ENDREGISTRATION, atur ke kode kesalahan sistem .

FailureCode

Untuk pemberitahuan SPFILENOTIFY_STARTREGISTRATION, anggota ini tidak digunakan dan harus diatur ke SPREG_SUCCESS. Untuk pemberitahuan SPFILENOTIFY_ENDREGISTRATION, atur ke salah satu kode kegagalan berikut yang menunjukkan hasil pendaftaran.

Nilai	Arti
SPREG_SUCCESS	File berhasil didaftarkan atau tidak terdaftar. WinError tidak digunakan.
SPREG_LOADLIBRARY	loadLibrary gagal untuk file. WinError berisi kode kesalahan yang diperluas dari komponen.
SPREG_GETPROCADDR	GetProcAddress gagal untuk file tersebut. WinError berisi kode kesalahan yang diperluas dari komponen.
SPREG_REGSVR	DLLRegisterServer titik masuk mengembalikan kegagalan. WinError berisi kode kesalahan yang diperluas dari komponen.
SPREG_DLLINSTALL	DLLInstall titik masuk mengembalikan kegagalan. WinError berisi kode kesalahan yang diperluas dari komponen.
SPREG_TIMEOUT	Pendaftaran file atau unregistration melebihi batas waktu yang ditentukan. WinError diatur ke ERROR_TIMEOUT.
SPREG_UNKNOWN	Pendaftaran file atau pembatasan registrasi gagal karena alasan yang tidak diketahui. WinError menunjukkan kode kesalahan yang diperluas dari komponen.

Komentar

Nota

Header setupapi.h mendefinisikan SP_REGISTER_CONTROL_STATUS sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	setupapi.h

Lihat juga

Gambaran Umum

SPFILENOTIFY_ENDREGISTRATION

SPFILENOTIFY_STARTREGISTRATION

SetupInstallFromInfSection

Struktur