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 |
|
| Biblioteca de tipos |
|
| DLL |
|
| CLSID |
CLSID_SWbemPrivilegeSet |
| IID |
IID_ISWbemPrivilegeSet |