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

  • Artículo

La función de devolución de llamada PFSCE_QUERY_INFO consulta información específica del servicio desde el archivo de configuración de seguridad o la base de datos de análisis.

Sintaxis

PFSCE_QUERY_INFO PfsceQueryInfo;

SCESTATUS PfsceQueryInfo(
  [in]           SCE_HANDLE sceHandle,
  [in]           SCESVC_INFO_TYPE sceType,
  [in, optional] LPTSTR lpPrefix,
  [in]           BOOL bExact,
  [out]          PVOID *ppvInfo,
  [out]          PSCE_ENUMERATION_CONTEXT psceEnumHandle
)
{...}

Parámetros

[in] sceHandle

Tipo: SCE_HANDLE

Especifica el identificador 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 almacenar la información consultada.

[in] sceType

Tipo: SCESVC_INFO_TYPE

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

Valor Significado
SCE_SERVICE_CONFIGURATION_INFO
 Solicita información de configuración de la base de datos.
SCE_SERVICE_ANALYSIS_INFO
 Solicita información de análisis de la base de datos.

[in, optional] lpPrefix

Tipo: LPTSTR

Especifica un prefijo o una clave (vea bExact) para limitar la consulta. Cuando se proporciona una cadena, solo se devuelven las claves (y sus valores correspondientes) que coinciden con la cadena. Cuando se establece en NULL, se devuelven todas las claves.

[in] bExact

Tipo: BOOL

Especifica si la cadena proporcionada por lpPrefix debe tratarse como una clave específica o un prefijo. 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 devuelven registros que coincidan con esa clave.
FALSE
 La cadena especificada por lpPrefix representa un prefijo. Se devuelven todas las claves (y sus valores) que tienen este mismo prefijo.

[out] ppvInfo

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.

[out] psceEnumHandle

Tipo: PSCE_ENUMERATION_CONTEXT

Devuelve un identificador que se puede usar en llamadas sucesivas a esta función. Debido al gran número de claves que pueden estar presentes, no todas las claves se devuelven en una sola llamada. El número máximo de claves que se pueden devolver en una sola llamada es 256.

Valor devuelto

Tipo: SCESTATUS

Valor SCESTATUS que indica el resultado de la llamada de función. 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_INVALID_PARAMETER
 Uno de los parámetros pasados a la función no era válido.
SCESTATUS_RECORD_NOT_FOUND
 No se encontró el registro especificado en la base de datos de seguridad.
SCESTATUS_BAD_FORMAT
 El formato no es válido.
SCESTATUS_OTHER_ERROR
 Error no especificado.
SCESTATUS_NOT_ENOUGH_RESOURCE
 No hay memoria suficiente.

Comentarios

El conjunto de herramientas de configuración de seguridad asigna búferes cuando se llama a PFSCE_QUERY_INFO . Para liberar estos búferes, llame a PFSCE_FREE_INFO después de que ya no se necesite la información devuelta.

Ejemplos

Para obtener un ejemplo de Vea
Recuperación de información de configuración Implementación de SceSvcAttachmentConfig
Recuperación de información de análisis Implementación de SceSvcAttachmentAnalyze
Recuperación de información de configuración y análisis Implementación de SceSvcAttachmentUpdate
 

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_FREE_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO