Função EcOpenSubscription (evcoll.h)

Artigo
02/28/2024

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

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	evcoll.h
Biblioteca	Wecapi.lib
DLL	Wecapi.dll

Confira também

Funções do Coletor de Eventos do Windows

Compartilhar via