PFSCE_QUERY_INFO função de retorno de chamada (scesvc.h)
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 |
|---|---|
|
Solicita informações de configuração do banco de dados. |
|
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.
[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 |
|---|---|
|
Quando sceType é definido como SCE_SERVICE_CONFIGURATION_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 |
|---|---|
|
Um dos parâmetros passados para a função não era válido. |
|
O registro especificado não foi encontrado no banco de dados de segurança. |
|
O formato não é válido. |
|
Ocorreu um erro não especificado. |
|
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 |