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

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

Confira também

__InstanceOperationEvent

Classes de sistema do WMI