Método SWbemPrivilegeSet.Add

O método Add do objeto SWbemPrivilegeSet adiciona um objeto SWbemPrivilege à coleção SWbemPrivilegeSet. Se um privilégio com o mesmo nome já existir na coleção, ele será substituído.

Para obter uma explicação dessa sintaxe, confira Convenções de documentação para a API de Script.

Sintaxe

objPrivilege = .Add( _
  ByVal iPrivilege, _
  [ ByVal bIsEnabled ] _
)

Parâmetros

iPrivilege

Obrigatórios. Uma das constantes do WMI do grupo WbemPrivilegeEnum. Essas constantes são essencialmente inteiros que representam privilégios específicos. Por exemplo, para adicionar o privilégio que permite desligar um sistema de computador, use a constante wbemPrivilegeShutdown. Em um script, você deve usar o equivalente numérico de 23 (0x17). Para obter uma lista completa dessas constantes e as cadeias de caracteres de privilégio associadas, confira Constantes de privilégio.

bIsEnabled [opcional]

Valor booliano que habilita ou desabilita esse privilégio. O valor padrão é TRUE.

Retornar valor

Se tiver êxito, o método retornará um objeto SWbemPrivilege que representa o novo privilégio. Caso contrário, um objeto nulo será retornado.

Códigos do Erro

Após a conclusão do método Add, o objeto Err pode conter o código de erro na lista a seguir.

wbemErrFailed – 2147749889 (0x80041001)

Erro não especificado.

Exemplos

Um exemplo de código que usa esse método é descrito no tópico SWbemPrivilegeSet.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	Wbemdisp.h
Biblioteca de tipos	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemPrivilegeSet
IID	IID_ISWbemPrivilegeSet

Confira também

SWbemPrivilegeSet

Executar operações privilegiadas

Como executar operações privilegiadas usando VBScript

SWbemPrivilegeSet.AddAsString

SWbemPrivilegeSet.Remove

WbemPrivilegeEnum

Constantes de privilégio