PFSCE_QUERY_INFO função de retorno de chamada (scesvc.h)

  • Artigo

A função de retorno de chamada PFSCE_QUERY_INFO consulta informações específicas do serviço do arquivo de Configuração de Segurança ou do banco de dados de análise.

Sintaxe

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 o identificador opaco passado para o anexo pela ferramenta configuração de segurança definida durante a chamada para ISceSvcAttachmentData::Initialize. Esse identificador é usado para armazenar as informações consultadas.

[in] sceType

Tipo: SCESVC_INFO_TYPE

Especifica o tipo de informação a ser consultada. Especifique um dos sinalizadores a seguir.

Valor Significado
SCE_SERVICE_CONFIGURATION_INFO
 Solicita informações de configuração do banco de dados.
SCE_SERVICE_ANALYSIS_INFO
 Solicita informações de análise do banco de dados.

[in, optional] lpPrefix

Tipo: LPTSTR

Especifica um prefixo ou chave (consulte bExact) para limitar a consulta. Quando uma cadeia de caracteres é fornecida, somente as chaves (e seus valores correspondentes) que correspondem à cadeia de caracteres são retornadas. Quando definido como NULL, todas as chaves são retornadas.

[in] bExact

Tipo: BOOL

Especifica se a cadeia de caracteres fornecida pelo lpPrefix deve ser tratada como uma chave específica ou um prefixo. Esse parâmetro será ignorado se lpPrefix estiver definido como NULL. Especifique um dos valores a seguir.

Valor Significado
TRUE
 A cadeia de caracteres especificada em lpPrefix representa uma chave específica. Somente registros correspondentes a essa chave são retornados.
FALSE
 A cadeia de caracteres especificada por lpPrefix representa um prefixo. Todas as chaves (e seus valores) que têm esse mesmo prefixo são retornadas.

[out] ppvInfo

Tipo: PVOID*

Retorna um ponteiro para uma das estruturas a seguir. O conjunto de ferramentas de Configuração de Segurança (não o anexo) aloca o buffer para as informações; portanto, esse ponteiro deve apontar para NULL.

Valor Significado
SCESVC_CONFIGURATION_INFO
 Quando sceType é definido como SCE_SERVICE_CONFIGURATION_INFO.
SCESVC_ANALYSIS_INFO
 Quando sceType é definido como SCE_SERVICE_ANALYSIS_INFO.

[out] psceEnumHandle

Tipo: PSCE_ENUMERATION_CONTEXT

Retorna um identificador que pode ser usado em chamadas sucessivas para essa função. Devido ao grande número de chaves que podem estar presentes, nem todas as chaves são retornadas em uma única chamada. O número máximo de chaves que podem ser retornadas em uma única chamada é 256.

Retornar valor

Tipo: SCESTATUS

Um valor SCESTATUS que indica o resultado da chamada de função. Se a função for bem-sucedida, ela retornará SCESTATUS_SUCCESS; caso contrário, ele retornará um valor de erro, que pode ser um dos seguintes.

Código de retorno Descrição
SCESTATUS_INVALID_PARAMETER
 Um dos parâmetros passados para a função não era válido.
SCESTATUS_RECORD_NOT_FOUND
 O registro especificado não foi encontrado no banco de dados de segurança.
SCESTATUS_BAD_FORMAT
 O formato não é válido.
SCESTATUS_OTHER_ERROR
 Ocorreu um erro não especificado.
SCESTATUS_NOT_ENOUGH_RESOURCE
 Não há memória suficiente.

Comentários

O conjunto de ferramentas configuração de segurança aloca buffers quando PFSCE_QUERY_INFO é chamado. Para liberar esses buffers , chame PFSCE_FREE_INFO depois que as informações retornadas não forem mais necessárias.

Exemplos

Para um exemplo de Consulte
Recuperando informações de configuração Implementando SceSvcAttachmentConfig
Recuperando informações de análise Implementando SceSvcAttachmentAnalyze
Recuperando informações de configuração e análise Implementando SceSvcAttachmentUpdate
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho scesvc.h

Confira também

PFSCE_FREE_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO