PFSCE_SET_INFO function pointer
The PFSCE_SET_INFO callback function sets or overwrites service-specific configuration and analysis information.
Syntax
typedef SCESTATUS ( *PFSCE_SET_INFO)(
_In_ SCE_HANDLE sceHandle,
_In_ SCESVC_INFO_TYPE sceType,
_In_opt_ LPTSTR lpPrefix,
_In_ BOOL bExact,
_In_ PVOID pvInfo
);
Parameters
- sceHandle [in]
-
Type: SCE_HANDLE
Specifies the opaque SCE handle passed to the attachment by the Security Configuration tool set during the call to ISceSvcAttachmentData::Initialize. This handle is used to set or overwrite the information.
- sceType [in]
-
Type: SCESVC_INFO_TYPE
Specifies the type of information to be set. Specify one of the following flags.
Value Meaning - SCE_SERVICE_CONFIGURATION_INFO
Indicates that configuration information is set.
- SCE_SERVICE_ANALYSIS_INFO
Indicates that analysis information is set.
- lpPrefix [in, optional]
-
Type: LPTSTR
Specifies what information should be set or overwritten. This string can specify a specific key (see bExact) or a prefix for a set of keys. When a string is supplied, only information for those keys (and their corresponding values) that match the string is set. When set to NULL, all information for the service is set.
- bExact [in]
-
Type: BOOL
Specifies whether the string provided by lpPrefix should be treated as a specific key or a prefix for a set of keys. This parameter is ignored if lpPrefix is set to NULL.
Specify one of the following values.
- pvInfo [in]
-
Type: PVOID
Returns a pointer to one of the following structures. The Security Configuration tool set (not the attachment) allocates the buffer for the information; therefore, this pointer must point to NULL.
Value Meaning - SCESVC_CONFIGURATION_INFO
When sceType is set to SCE_SERVICE_CONFIGURATION_INFO.
- SCESVC_ANALYSIS_INFO
When sceType is set to SCE_SERVICE_ANALYSIS_INFO.
Return value
Type: SCESTATUS
If the function succeeds, it returns SCESTATUS_SUCCESS; otherwise, it returns an error value which can be one of the following.
| Return code | Description |
|---|---|
|
The caller does not have sufficient privileges to complete this action. |
|
The format is bad. |
|
There is more data than the buffer can hold. |
|
One of the parameters passed into the function was not valid. |
|
There is insufficient memory. |
|
An unspecified error has occurred. |
|
The specified record was not found in the security database. |
Examples
| For an example of | See |
|---|---|
| Setting analysis information | Implementing SceSvcAttachmentAnalyze |
| Setting configuration and analysis information | Implementing SceSvcAttachmentUpdate |
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
See also