Condividi tramite


PFSCE_SET_INFO funzione di callback (scesvc.h)

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