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

Artigo
08/25/2023

A função de retorno de chamada PFSCE_SET_INFO define ou substitui informações de análise e configuração específicas do serviço.

Sintaxe

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

[in] sceType

Tipo: SCESVC_INFO_TYPE

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

Valor	Significado
SCE_SERVICE_CONFIGURATION_INFO	Indica que as informações de configuração estão definidas.
SCE_SERVICE_ANALYSIS_INFO	Indica que as informações de análise estão definidas.

[in, optional] lpPrefix

Tipo: LPTSTR

Especifica quais informações devem ser definidas ou substituídas. Essa cadeia de caracteres pode especificar uma chave específica (consulte bExact) ou um prefixo para um conjunto de chaves. Quando uma cadeia de caracteres é fornecida, somente as informações para essas chaves (e seus valores correspondentes) que correspondem à cadeia de caracteres são definidas. Quando definido como NULL, todas as informações do serviço são definidas.

[in] bExact

Tipo: BOOL

Especifica se a cadeia de caracteres fornecida por lpPrefix deve ser tratada como uma chave específica ou um prefixo para um conjunto de chaves. 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 essa chave está definida.
FALSE	A cadeia de caracteres especificada por lpPrefix representa um prefixo para um conjunto de chaves. Todas as chaves (e seus valores) que têm o mesmo prefixo estão definidas.

[in] pvInfo

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.

Retornar valor

Tipo: SCESTATUS

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

Código de retorno	Descrição
SCESTATUS_ACCESS_DENIED	O chamador não tem privilégios suficientes para concluir essa ação.
SCESTATUS_BAD_FORMAT	O formato é inválido.
SCESTATUS_PREFIX_OVERFLOW	Há mais dados do que o buffer pode conter.
SCESTATUS_INVALID_PARAMETER	Um dos parâmetros passados para a função não era válido.
SCESTATUS_NOT_ENOUGH_RESOURCE	Não há memória suficiente.
SCESTATUS_OTHER_ERROR	Ocorreu um erro não especificado.
SCESTATUS_RECORD_NOT_FOUND	O registro especificado não foi encontrado no banco de dados de segurança.

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_QUERY_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO