Função de retorno de chamada PFNGENERATEGROUPPOLICY (userenv.h)
A função de retorno de chamada GenerateGroupPolicy é uma função de retorno de chamada definida pelo aplicativo que cada extensão de política deve exportar ao gerar dados RSoP no modo de planejamento. O GPDAS (Serviço de Acesso a Dados do Política de Grupo) chama a função depois que o serviço simula o carregamento de extensões do lado do cliente para que as extensões possam gerar dados de política.
O tipo PFNGENERATEGROUPPOLICY define um ponteiro para essa função de retorno de chamada. GenerateGroupPolicy é um espaço reservado para o nome da função definida pelo aplicativo.
Sintaxe
PFNGENERATEGROUPPOLICY Pfngenerategrouppolicy;
DWORD Pfngenerategrouppolicy(
[in] DWORD dwFlags,
[in] BOOL *pbAbort,
[in] WCHAR *pwszSite,
[in] PRSOP_TARGET pComputerTarget,
[in] PRSOP_TARGET pUserTarget
)
{...}
Parâmetros
[in] dwFlags
Um parâmetro que representa um ou mais dos sinalizadores a seguir.
GPO_INFO_FLAG_SLOWLINK
A política é aplicada em um link lento.
GPO_INFO_FLAG_VERBOSE
Gravar saída detalhada no log de eventos.
[in] pbAbort
Um valor que especifica se os GPOs devem continuar processando. Se esse parâmetro for TRUE, o processamento de GPO será interrompido e a extensão deverá desalocar seus recursos e retornar prontamente. Se esse parâmetro for FALSE, o processamento de GPO continuará.
[in] pwszSite
Um ponteiro para o nome do site do computador de destino. Este parâmetro pode ser NULL.
[in] pComputerTarget
Um ponteiro para uma estrutura RSOP_TARGET que contém informações sobre um computador. Esse parâmetro pode ser NULL, mas se for NULL, o parâmetro pUserTarget será necessário.
[in] pUserTarget
Um ponteiro para uma estrutura RSOP_TARGET que contém informações sobre um usuário. Esse parâmetro pode ser NULL, mas se for NULL, o parâmetro pComputerTarget será necessário.
Retornar valor
Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS. Caso contrário, a função retornará um dos códigos de erro do sistema. Para obter uma lista completa de códigos de erro, consulte Códigos de erro do sistema ou o arquivo de cabeçalho WinError.h.
Comentários
A extensão de política deve registrar essa função de retorno de chamada na chave do Registro:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon\GPExtensions\ClientExtensionGuid
REG_SZ GenerateGroupPolicy
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | userenv.h |