PFSCE_SET_INFO funzione di callback (scesvc.h)

Articolo
03/08/2023

La funzione di callback PFSCE_SET_INFO imposta o sovrascrive le informazioni di analisi e configurazione specifiche del servizio.

Sintassi

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
)
{...}

Parametri

[in] sceHandle

Tipo: SCE_HANDLE

Specifica l'handle SCE opaco passato all'allegato dallo strumento Configurazione sicurezza impostato durante la chiamata a ISceSvcAttachmentData::Initialize. Questo handle viene usato per impostare o sovrascrivere le informazioni.

[in] sceType

Tipo: SCESVC_INFO_TYPE

Specifica il tipo di informazioni da impostare. Specificare uno dei flag seguenti.

Valore	Significato
SCE_SERVICE_CONFIGURATION_INFO	Indica che sono impostate le informazioni di configurazione.
SCE_SERVICE_ANALYSIS_INFO	Indica che le informazioni di analisi sono impostate.

[in, optional] lpPrefix

Tipo: LPTSTR

Specifica quali informazioni devono essere impostate o sovrascritte. Questa stringa può specificare una chiave specifica (vedere bExact) o un prefisso per un set di chiavi. Quando viene fornita una stringa, vengono impostate solo le informazioni relative a tali chiavi (e i relativi valori corrispondenti) che corrispondono alla stringa. Se impostato su NULL, vengono impostate tutte le informazioni per il servizio.

[in] bExact

Tipo: BOOL

Specifica se la stringa fornita da lpPrefix deve essere considerata come una chiave specifica o un prefisso per un set di chiavi. Questo parametro viene ignorato se lpPrefix è impostato su NULL.

Specificare uno dei valori seguenti.

Valore	Significato
TRUE	La stringa specificata in lpPrefix rappresenta una chiave specifica. Viene impostata solo la chiave.
FALSE	La stringa specificata da lpPrefix rappresenta un prefisso per un set di chiavi. Vengono impostate tutte le chiavi (e i relativi valori) con lo stesso prefisso.

[in] pvInfo

Tipo: PVOID

Restituisce un puntatore a una delle strutture seguenti. Il set di strumenti di configurazione della sicurezza (non l'allegato) alloca il buffer per le informazioni; pertanto, questo puntatore deve puntare a NULL.

Valore	Significato
SCESVC_CONFIGURATION_INFO	Quando sceType è impostato su SCE_SERVICE_CONFIGURATION_INFO.
SCESVC_ANALYSIS_INFO	Quando sceType è impostato su SCE_SERVICE_ANALYSIS_INFO.

Valore restituito

Tipo: SCESTATUS

Se la funzione ha esito positivo, restituisce SCESTATUS_SUCCESS; in caso contrario, restituisce un valore di errore che può essere uno dei seguenti.

Codice restituito	Descrizione
SCESTATUS_ACCESS_DENIED	Il chiamante non dispone di privilegi sufficienti per completare questa azione.
SCESTATUS_BAD_FORMAT	Il formato non è valido.
SCESTATUS_PREFIX_OVERFLOW	Sono presenti più dati che il buffer può contenere.
SCESTATUS_INVALID_PARAMETER	Uno dei parametri passati alla funzione non è valido.
SCESTATUS_NOT_ENOUGH_RESOURCE	Memoria insufficiente.
SCESTATUS_OTHER_ERROR	Si è verificato un errore non specificato.
SCESTATUS_RECORD_NOT_FOUND	Il record specificato non è stato trovato nel database di sicurezza.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	scesvc.h

Vedi anche

PFSCE_QUERY_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO

Condividi tramite