PFSCE_SET_INFO función de devolución de llamada (scesvc.h)

Artículo
08/25/2023

La PFSCE_SET_INFO función de devolución de llamada establece o sobrescribe información de análisis y configuración específica del servicio.

Sintaxis

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

Parámetros

[in] sceHandle

Tipo: SCE_HANDLE

Especifica el identificador SCE opaco pasado a los datos adjuntos por la herramienta de configuración de seguridad establecida durante la llamada a ISceSvcAttachmentData::Initialize. Este identificador se usa para establecer o sobrescribir la información.

[in] sceType

Tipo: SCESVC_INFO_TYPE

Especifica el tipo de información que se va a establecer. Especifique una de las marcas siguientes.

Valor	Significado
SCE_SERVICE_CONFIGURATION_INFO	Indica que se ha establecido la información de configuración.
SCE_SERVICE_ANALYSIS_INFO	Indica que se ha establecido información de análisis.

[in, optional] lpPrefix

Tipo: LPTSTR

Especifica qué información se debe establecer o sobrescribir. Esta cadena puede especificar una clave específica (vea bExact) o un prefijo para un conjunto de claves. Cuando se proporciona una cadena, solo se establece la información de esas claves (y sus valores correspondientes) que coincidan con la cadena. Cuando se establece en NULL, se establece toda la información del servicio.

[in] bExact

Tipo: BOOL

Especifica si la cadena proporcionada por lpPrefix debe tratarse como una clave específica o un prefijo para un conjunto de claves. Este parámetro se omite si lpPrefix está establecido en NULL.

Especifique uno de los valores siguientes.

Valor	Significado
TRUE	La cadena especificada en lpPrefix representa una clave específica. Solo se establece esa clave.
FALSE	La cadena especificada por lpPrefix representa un prefijo para un conjunto de claves. Se establecen todas las claves (y sus valores) que tienen el mismo prefijo.

[in] pvInfo

Tipo: PVOID

Devuelve un puntero a una de las estructuras siguientes. El conjunto de herramientas de configuración de seguridad (no los datos adjuntos) asigna el búfer para la información; por lo tanto, este puntero debe apuntar a NULL.

Valor	Significado
SCESVC_CONFIGURATION_INFO	Cuando sceType se establece en SCE_SERVICE_CONFIGURATION_INFO.
SCESVC_ANALYSIS_INFO	Cuando sceType se establece en SCE_SERVICE_ANALYSIS_INFO.

Valor devuelto

Tipo: SCESTATUS

Si la función se realiza correctamente, devuelve SCESTATUS_SUCCESS; de lo contrario, devuelve un valor de error que puede ser uno de los siguientes.

Código devuelto	Descripción
SCESTATUS_ACCESS_DENIED	El autor de la llamada no tiene privilegios suficientes para completar esta acción.
SCESTATUS_BAD_FORMAT	El formato es incorrecto.
SCESTATUS_PREFIX_OVERFLOW	Hay más datos de los que el búfer puede contener.
SCESTATUS_INVALID_PARAMETER	Uno de los parámetros pasados a la función no era válido.
SCESTATUS_NOT_ENOUGH_RESOURCE	No hay memoria suficiente.
SCESTATUS_OTHER_ERROR	Error no especificado.
SCESTATUS_RECORD_NOT_FOUND	No se encontró el registro especificado en la base de datos de seguridad.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	scesvc.h

Consulte también

PFSCE_QUERY_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO

Compartir a través de