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

  • Artículo

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