PFSCE_QUERY_INFO fonction de rappel (scesvc.h)

Article
08/25/2023

La fonction de rappel PFSCE_QUERY_INFO interroge des informations spécifiques au service à partir du fichier de configuration de la sécurité ou de la base de données d’analyse.

Syntaxe

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

Paramètres

[in] sceHandle

Type : SCE_HANDLE

Spécifie le handle opaque passé à la pièce jointe par l’outil Configuration de la sécurité défini lors de l’appel à ISceSvcAttachmentData ::Initialize. Ce handle est utilisé pour stocker les informations interrogées.

[in] sceType

Type : SCESVC_INFO_TYPE

Spécifie le type d’informations à interroger. Spécifiez l’un des indicateurs suivants.

Valeur	Signification
SCE_SERVICE_CONFIGURATION_INFO	Demande des informations de configuration à partir de la base de données.
SCE_SERVICE_ANALYSIS_INFO	Demande des informations d’analyse à partir de la base de données.

[in, optional] lpPrefix

Type : LPTSTR

Spécifie un préfixe ou une clé (voir bExact) pour limiter la requête. Lorsqu’une chaîne est fournie, seules les clés (et leurs valeurs correspondantes) qui correspondent à la chaîne sont retournées. Lorsque la valeur est NULL, toutes les clés sont retournées.

[in] bExact

Type : BOOL

Spécifie si la chaîne fournie par lpPrefix doit être traitée comme une clé ou un préfixe spécifique. Ce paramètre est ignoré si lpPrefix a la valeur NULL. Spécifiez l’une des valeurs suivantes.

Valeur	Signification
TRUE	La chaîne spécifiée dans lpPrefix représente une clé spécifique. Seuls les enregistrements correspondant à cette clé sont retournés.
FALSE	La chaîne spécifiée par lpPrefix représente un préfixe. Toutes les clés (et leurs valeurs) qui ont ce même préfixe sont retournées.

[out] ppvInfo

Type : PVOID*

Retourne un pointeur vers l’une des structures suivantes. L’ensemble de l’outil Configuration de la sécurité (et non la pièce jointe) alloue la mémoire tampon pour les informations ; Par conséquent, ce pointeur doit pointer vers NULL.

Valeur	Signification
SCESVC_CONFIGURATION_INFO	Lorsque sceType est défini sur SCE_SERVICE_CONFIGURATION_INFO.
SCESVC_ANALYSIS_INFO	Lorsque sceType est défini sur SCE_SERVICE_ANALYSIS_INFO.

[out] psceEnumHandle

Type : PSCE_ENUMERATION_CONTEXT

Retourne un handle qui peut être utilisé dans les appels successifs à cette fonction. En raison du grand nombre de clés qui peuvent être présentes, toutes les clés ne sont pas retournées en un seul appel. Le nombre maximal de clés pouvant être retournées dans un seul appel est de 256.

Valeur retournée

Type : SCESTATUS

Valeur SCESTATUS qui indique le résultat de l’appel de fonction. Si la fonction réussit, elle retourne SCESTATUS_SUCCESS ; sinon, elle retourne une valeur d’erreur, qui peut être l’une des suivantes.

Code de retour	Description
SCESTATUS_INVALID_PARAMETER	L’un des paramètres transmis à la fonction n’était pas valide.
SCESTATUS_RECORD_NOT_FOUND	L’enregistrement spécifié est introuvable dans la base de données de sécurité.
SCESTATUS_BAD_FORMAT	Le format n’est pas valide.
SCESTATUS_OTHER_ERROR	Une erreur inconnue s’est produite.
SCESTATUS_NOT_ENOUGH_RESOURCE	La mémoire est insuffisante.

Remarques

L’ensemble de l’outil Configuration de la sécurité alloue des mémoires tampons quand PFSCE_QUERY_INFO est appelée. Pour libérer ces mémoires tampons, appelez PFSCE_FREE_INFO une fois que les informations retournées ne sont plus nécessaires.

Exemples

Pour obtenir un exemple de	Consultez
Récupération des informations de configuration	Implémentation de SceSvcAttachmentConfig
Récupération des informations d’analyse	Implémentation de SceSvcAttachmentAnalyze
Récupération des informations de configuration et d’analyse	Implémentation de SceSvcAttachmentUpdate

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	scesvc.h

Voir aussi

PFSCE_FREE_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO

Partager via