Funzione EcOpenSubscription (evcoll.h)

La funzione EcOpenSubscription viene usata per aprire una sottoscrizione esistente o creare una nuova sottoscrizione in base al valore del flag specificato.

Sintassi

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

Parametri

[in] SubscriptionName

Specifica il nome della sottoscrizione. Il valore specificato per questo parametro deve essere univoco nell'ambito del computer.

[in] AccessMask

Maschera di accesso che specifica i diritti di accesso desiderati per la sottoscrizione. Usare le costanti EC_READ_ACCESS o EC_WRITE_ACCESS per specificare i diritti di accesso. La funzione ha esito negativo se il descrittore di sicurezza della sottoscrizione non consente l'accesso richiesto per il processo chiamante.

[in] Flags

Valore che specifica se verrà aperta una sottoscrizione nuova o esistente. Usare le costanti EC_CREATE_NEW, EC_OPEN_ALWAYS o EC_OPEN_EXISTING .

Valore restituito

Se la funzione ha esito positivo, restituisce un handle (EC_HANDLE) a un nuovo oggetto sottoscrizione. Restituisce NULL in caso contrario, in questo caso usare la funzione GetLastError per ottenere il codice di errore.

Requisiti

Vedi anche

Funzioni dell'agente di raccolta eventi Windows