Função EcOpenSubscription (evcoll.h)

A função EcOpenSubscription é usada para abrir uma assinatura existente ou criar uma nova assinatura de acordo com o valor do sinalizador especificado.

Sintaxe

EC_HANDLE EcOpenSubscription(
  [in] LPCWSTR SubscriptionName,
  [in] DWORD   AccessMask,
  [in] DWORD   Flags
);

Parâmetros

[in] SubscriptionName

Especifica o nome da assinatura. O valor fornecido para esse parâmetro deve ser exclusivo dentro do escopo do computador.

[in] AccessMask

Uma máscara de acesso que especifica os direitos de acesso desejados à assinatura. Use as constantes EC_READ_ACCESS ou EC_WRITE_ACCESS para especificar os direitos de acesso. A função falhará se o descritor de segurança da assinatura não permitir o acesso solicitado para o processo de chamada.

[in] Flags

Um valor que especifica se uma assinatura nova ou existente será aberta. Use as constantes EC_CREATE_NEW, EC_OPEN_ALWAYS ou EC_OPEN_EXISTING .

Retornar valor

Se a função for bem-sucedida, ela retornará um identificador (EC_HANDLE) para um novo objeto de assinatura. Retorna NULL caso contrário, nesse caso, use a função GetLastError para obter o código de erro.

Requisitos

Confira também

Funções do Coletor de Eventos do Windows