PFSCE_QUERY_INFO funzione di callback (scesvc.h)

Articolo
03/01/2024

La funzione di callback PFSCE_QUERY_INFO esegue una query sulle informazioni specifiche del servizio dal database di configurazione della sicurezza o dall'analisi.

Sintassi

PFSCE_QUERY_INFO PfsceQueryInfo;

SCESTATUS PfsceQueryInfo(
  [in]           SCE_HANDLE sceHandle,
  [in]           SCESVC_INFO_TYPE sceType,
  [in, optional] LPTSTR lpPrefix,
  [in]           BOOL bExact,
  [out]          PVOID *ppvInfo,
  [out]          PSCE_ENUMERATION_CONTEXT psceEnumHandle
)
{...}

Parametri

[in] sceHandle

Tipo: SCE_HANDLE

Specifica l'handle opaco passato all'allegato dallo strumento Configurazione sicurezza impostato durante la chiamata a ISceSvcAttachmentData::Initialize. Questo handle viene usato per archiviare le informazioni sottoposte a query.

[in] sceType

Tipo: SCESVC_INFO_TYPE

Specifica il tipo di informazioni su cui eseguire una query. Specificare uno dei flag seguenti.

Valore	Significato
SCE_SERVICE_CONFIGURATION_INFO	Richiede informazioni di configurazione dal database.
SCE_SERVICE_ANALYSIS_INFO	Richiede informazioni di analisi dal database.

[in, optional] lpPrefix

Tipo: LPTSTR

Specifica un prefisso o una chiave (vedere bExact) per limitare la query. Quando viene specificata una stringa, vengono restituite solo le chiavi (e i relativi valori corrispondenti) che corrispondono alla stringa. Se impostato su NULL, vengono restituite tutte le chiavi.

[in] bExact

Tipo: BOOL

Specifica se la stringa fornita da lpPrefix deve essere considerata come una chiave specifica o un prefisso. 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. Vengono restituiti solo i record corrispondenti a tale chiave.
FALSE	La stringa specificata da lpPrefix rappresenta un prefisso. Vengono restituite tutte le chiavi (e i relativi valori) con lo stesso prefisso.

[out] ppvInfo

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.

[out] psceEnumHandle

Tipo: PSCE_ENUMERATION_CONTEXT

Restituisce un handle che può essere utilizzato nelle chiamate successive a questa funzione. A causa del numero elevato di chiavi che possono essere presenti, non tutte le chiavi vengono restituite in una singola chiamata. Il numero massimo di chiavi che possono essere restituite in una singola chiamata è 256.

Valore restituito

Tipo: SCESTATUS

Valore SCESTATUS che indica il risultato della chiamata di funzione. 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_INVALID_PARAMETER	Uno dei parametri passati alla funzione non è valido.
SCESTATUS_RECORD_NOT_FOUND	Il record specificato non è stato trovato nel database di sicurezza.
SCESTATUS_BAD_FORMAT	Formato non valido.
SCESTATUS_OTHER_ERROR	Si è verificato un errore non specificato.
SCESTATUS_NOT_ENOUGH_RESOURCE	Memoria insufficiente.

Commenti

Il set di strumenti di configurazione della sicurezza alloca i buffer quando viene chiamato PFSCE_QUERY_INFO . Per liberare questi buffer, chiamare PFSCE_FREE_INFO dopo che le informazioni restituite non sono più necessarie.

Esempio

Per un esempio di	Vedere
Recupero delle informazioni di configurazione	Implementazione di SceSvcAttachmentConfig
Recupero delle informazioni di analisi	Implementazione di SceSvcAttachmentAnalyze
Recupero delle informazioni di configurazione e analisi	Implementazione di SceSvcAttachmentUpdate

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_FREE_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO

Condividi tramite