Función EcOpenSubscription (evcoll.h)

  • Artículo

La función EcOpenSubscription se usa para abrir una suscripción existente o crear una nueva suscripción según el valor de marca especificado.

Sintaxis

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

Parámetros

[in] SubscriptionName

Especifica el nombre de la suscripción. El valor proporcionado para este parámetro debe ser único dentro del ámbito del equipo.

[in] AccessMask

Máscara de acceso que especifica los derechos de acceso deseados para la suscripción. Use las constantes EC_READ_ACCESS o EC_WRITE_ACCESS para especificar los derechos de acceso. Se produce un error en la función si el descriptor de seguridad de la suscripción no permite el acceso solicitado para el proceso de llamada.

[in] Flags

Valor que especifica si se abrirá una suscripción nueva o existente. Use las constantes EC_CREATE_NEW, EC_OPEN_ALWAYS o EC_OPEN_EXISTING .

Valor devuelto

Si la función se ejecuta correctamente, devuelve un identificador (EC_HANDLE) a un nuevo objeto de suscripción. Devuelve NULL de lo contrario, en cuyo caso se usa la función GetLastError para obtener el código de error.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado evcoll.h
Library Wecapi.lib
Archivo DLL Wecapi.dll

Consulte también

Funciones del recopilador de eventos de Windows