Classe __InstanceCreationEvent
A classe do sistema __InstanceCreationEvent relata um evento de criação de instância, que é um tipo de evento intrínseco gerado quando uma nova instância é adicionada ao namespace.
A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades são listadas em ordem alfabética e não na ordem do MOF.
Sintaxe
class __InstanceCreationEvent : __InstanceOperationEvent
{
uint8 SECURITY_DESCRIPTOR[];
object TargetInstance;
uint64 TIME_CREATED;
};
Membros
A classe __InstanceCreationEvent tem estes tipos de membros:
Propriedades
A classe __InstanceCreationEvent tem estas propriedades.
-
SECURITY_DESCRIPTOR
-
-
Tipo de dados: matriz uint8
-
Tipo de acesso: Somente leitura
Descritor usado pelo provedor de eventos para determinar quais usuários podem receber o evento. Essa propriedade é herdada de __Event.
-
-
TargetInstance
-
-
Tipo de dados: object
-
Tipo de acesso: Somente leitura
Cópia da instância que foi criada. Essa propriedade é herdada de __InstanceOperationEvent.
-
-
TIME_CREATED
-
-
Tipo de dados: uint64
-
Tipo de acesso: Somente leitura
Valor exclusivo que indica a hora em que o evento foi gerado. Esse é um valor de 64 bits que representa o número de intervalos de 100 nanossegundos após 1° de janeiro de 1601. As informações estão no formato UTC (Tempo Universal Coordenado). Essa propriedade é herdada de __Event.
Para obter mais informações sobre como usar valores uint64 em scripts, confira Scripts no WMI.
-
Comentários
A classe __InstanceCreationEvent é derivada de __InstanceOperationEvent.
Criação de um recurso: __InstanceCreationEvent
Suponha que você tenha interesse em receber uma notificação se o Bloco de Notas for executado em um determinado computador. Quando o Bloco de Notas é executado, um processo correspondente é criado. Os processos podem ser gerenciados usando o WMI e são representados pela classe Win32_Process. Quando o Bloco de Notas começa a ser executado, uma instância correspondente da classe Win32_Process fica disponível por meio do WMI. Se você tiver registrado seu interesse nesse evento (emitindo a consulta de notificação de evento apropriada), a disponibilidade dessa instância resultará na criação de uma instância da classe __InstanceCreationEvent.
As consultas de notificação que solicitam notificação da criação de um recurso e usam eventos intrínsecos usam sintaxe semelhante à seguinte:
SELECT * FROM __InstanceCreationEvent WITHIN PollingInterval WHERE TargetInstance ISA 'Win32_Process' and TargetInstance.Name = 'notepad.exe'
Para ver uma discussão mais ampla sobre como usar __InstanceCreationEvent como uma maneira de monitorar sistemas de arquivos, confira WMI e monitoramento do sistema de arquivos no CodeProject.
Exemplos
O exemplo Criar registro de evento WMI permanente para monitorar arquivos do PowerShell na Galeria do TechNet usa __InstanceCreationEvent como parte de um script complexo para configurar um registro de evento WMI permanente.
O exemplo do PowerShell Eventos Permanentes do WMI do PowerShell na Galeria do TechNet usa __InstanceCreationEvent como parte de um script de demonstração para configurar um registro de evento permanente.
O exemplo de código VBScript Monitorar evento de criação de processo na Galeria do TechNet usa __InstanceCreationEvent para monitorar o primeiro evento de criação de instância do WMI para Win32_Process.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Todos os namespaces do WMI |