PFSCE_SET_INFO fonction de rappel (scesvc.h)

Article
03/04/2024

La fonction de rappel PFSCE_SET_INFO définit ou remplace les informations de configuration et d’analyse propres au service.

Syntaxe

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

Paramètres

[in] sceHandle

Type : SCE_HANDLE

Spécifie le handle SCE 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 définir ou remplacer les informations.

[in] sceType

Type : SCESVC_INFO_TYPE

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

Valeur	Signification
SCE_SERVICE_CONFIGURATION_INFO	Indique que les informations de configuration sont définies.
SCE_SERVICE_ANALYSIS_INFO	Indique que les informations d’analyse sont définies.

[in, optional] lpPrefix

Type : LPTSTR

Spécifie les informations qui doivent être définies ou remplacées. Cette chaîne peut spécifier une clé spécifique (voir bExact) ou un préfixe pour un ensemble de clés. Lorsqu’une chaîne est fournie, seules les informations relatives aux clés (et leurs valeurs correspondantes) qui correspondent à la chaîne sont définies. Lorsqu’il est défini sur NULL, toutes les informations relatives au service sont définies.

[in] bExact

Type : BOOL

Spécifie si la chaîne fournie par lpPrefix doit être traitée comme une clé spécifique ou un préfixe pour un ensemble de clés. 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. Seule cette clé est définie.
FALSE	La chaîne spécifiée par lpPrefix représente un préfixe pour un ensemble de clés. Toutes les clés (et leurs valeurs) qui ont le même préfixe sont définies.

[in] pvInfo

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.

Valeur retournée

Type : SCESTATUS

Si la fonction réussit, elle retourne SCESTATUS_SUCCESS ; sinon, il retourne une valeur d’erreur qui peut être l’une des suivantes.

Code de retour	Description
SCESTATUS_ACCESS_DENIED	L’appelant ne dispose pas des privilèges suffisants pour effectuer cette action.
SCESTATUS_BAD_FORMAT	Le format est incorrect.
SCESTATUS_PREFIX_OVERFLOW	Il y a plus de données que la mémoire tampon peut contenir.
SCESTATUS_INVALID_PARAMETER	L’un des paramètres passés à la fonction n’était pas valide.
SCESTATUS_NOT_ENOUGH_RESOURCE	La mémoire est insuffisante.
SCESTATUS_OTHER_ERROR	Une erreur inconnue s’est produite.
SCESTATUS_RECORD_NOT_FOUND	L’enregistrement spécifié est introuvable dans la base de données de sécurité.

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_QUERY_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO

Partager via