PFSCE_QUERY_INFO funzione di callback (scesvc.h)

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.

[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.

[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.

[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.

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

Requisiti

Vedi anche

PFSCE_FREE_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO