Compartilhar via


Método IAutomaticUpdatesSettings2::CheckPermission (wuapi.h)

[IAutomaticUpdatesSettings2::CheckPermission não tem mais suporte. Começando com Windows 10 chamadas para CheckPermission sempre retornam S_OK e um valor retornado de VARIANT_TRUE (os usuários têm permissões). No entanto, IAutomaticUpdatesSettings::Save é uma no-op, portanto, nenhuma alteração pode ser feita.]

Determina se um usuário ou tipo específico de usuário tem permissão para executar uma ação selecionada.

Sintaxe

HRESULT CheckPermission(
  [in] AutomaticUpdatesUserType       userType,
  [in] AutomaticUpdatesPermissionType permissionType,
       VARIANT_BOOL                   *userHasPermission
);

Parâmetros

[in] userType

Uma enumeração que indica o tipo de usuário para verificar permissões.

[in] permissionType

Uma enumeração que indica o nível de permissão do usuário.

userHasPermission

True se o usuário tiver o tipo de permissão especificado; caso contrário, false.

Retornar valor

Retorna S_OK se tiver êxito. Caso contrário, retornará um código de erro COM ou Windows.

Comentários

Esse método pode ser usado para determinar se o Usuário Controle de Acesso (UAC) deve ser usado para executar uma ação no agente, o que pode evitar a necessidade de solicitação se o tipo de usuário não tiver permissão para executar a ação. Por exemplo, a menos que o agente tenha permissão elevada, a propriedade ReadOnly da interface IAutomaticUpdatesSettings sempre será VARIANT_TRUE. No entanto, mesmo depois que um usuário tiver sido elevado, notificationLevel (por exemplo) ainda pode ser somente leitura devido a configurações de Política de Grupo. O método CheckPermission pode determinar isso antes que a elevação seja feita para evitar solicitações em casos em que a configuração não pode ser alterada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP, Windows 2000 Professional com SP3 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003, Windows 2000 Server com SP3 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wuapi.h
Biblioteca Wuguid.lib
DLL Wuapi.dll

Confira também

IAutomaticUpdatesSettings2