PFSCE_SET_INFO fonction de rappel (scesvc.h)

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