PFSCE_QUERY_INFO funzione di callback (scesvc.h)

  • Articolo

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