PFSCE_SET_INFO fungsi panggilan balik (scesvc.h)

Artikel
03/08/2023

Fungsi panggilan balik PFSCE_SET_INFO menetapkan atau menimpa informasi konfigurasi dan analisis khusus layanan.

Sintaks

PFSCE_SET_INFO PfsceSetInfo;

SCESTATUS PfsceSetInfo(
  [in]           SCE_HANDLE sceHandle,
  [in]           SCESVC_INFO_TYPE sceType,
  [in, optional] LPTSTR lpPrefix,
  [in]           BOOL bExact,
  [in]           PVOID pvInfo
)
{...}

Parameter

[in] sceHandle

Jenis: SCE_HANDLE

Menentukan handel SCE buram yang diteruskan ke lampiran oleh alat Konfigurasi Keamanan yang diatur selama panggilan ke ISceSvcAttachmentData::Initialize. Handel ini digunakan untuk mengatur atau menimpa informasi.

[in] sceType

Jenis: SCESVC_INFO_TYPE

Menentukan tipe informasi yang akan disetel. Tentukan salah satu bendera berikut.

Nilai	Makna
SCE_SERVICE_CONFIGURATION_INFO	Menunjukkan bahwa informasi konfigurasi diatur.
SCE_SERVICE_ANALYSIS_INFO	Menunjukkan bahwa informasi analisis telah ditetapkan.

[in, optional] lpPrefix

Jenis: LPTSTR

Menentukan informasi apa yang harus diatur atau ditimpa. String ini dapat menentukan kunci tertentu (lihat bExact) atau awalan untuk sekumpulan kunci. Saat string disediakan, hanya informasi untuk kunci tersebut (dan nilai yang sesuai) yang cocok dengan string yang diatur. Ketika diatur ke NULL, semua informasi untuk layanan diatur.

[in] bExact

Jenis: BOOL

Menentukan apakah string yang disediakan oleh lpPrefix harus diperlakukan sebagai kunci tertentu atau awalan untuk sekumpulan kunci. Parameter ini diabaikan jika lpPrefix diatur ke NULL.

Tentukan salah satu nilai berikut ini.

Nilai	Makna
TRUE	String yang ditentukan dalam lpPrefix mewakili kunci tertentu. Hanya kunci yang diatur.
FALSE	String yang ditentukan oleh lpPrefix mewakili awalan untuk sekumpulan kunci. Semua kunci (dan nilainya) yang memiliki awalan yang sama diatur.

[in] pvInfo

Jenis: PVOID

Mengembalikan penunjuk ke salah satu struktur berikut. Set alat Konfigurasi Keamanan (bukan lampiran) mengalokasikan buffer untuk informasi; oleh karena itu, pointer ini harus menunjuk ke NULL.

Nilai	Makna
SCESVC_CONFIGURATION_INFO	Saat sceType diatur ke SCE_SERVICE_CONFIGURATION_INFO.
SCESVC_ANALYSIS_INFO	Saat sceType diatur ke SCE_SERVICE_ANALYSIS_INFO.

Nilai kembali

Jenis: SCESTATUS

Jika fungsi berhasil, fungsi akan mengembalikan SCESTATUS_SUCCESS; jika tidak, ia mengembalikan nilai kesalahan yang bisa menjadi salah satu dari yang berikut ini.

Menampilkan kode	Deskripsi
SCESTATUS_ACCESS_DENIED	Pemanggil tidak memiliki hak istimewa yang memadai untuk menyelesaikan tindakan ini.
SCESTATUS_BAD_FORMAT	Formatnya buruk.
SCESTATUS_PREFIX_OVERFLOW	Ada lebih banyak data daripada yang dapat dipegang buffer.
SCESTATUS_INVALID_PARAMETER	Salah satu parameter yang diteruskan ke fungsi tidak valid.
SCESTATUS_NOT_ENOUGH_RESOURCE	Memori tidak cukup.
SCESTATUS_OTHER_ERROR	Terjadi kesalahan yang tidak tentu.
SCESTATUS_RECORD_NOT_FOUND	Rekaman yang ditentukan tidak ditemukan di database keamanan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	scesvc.h

Lihat juga

PFSCE_QUERY_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO

Bagikan melalui