Funzione EcGetSubscriptionProperty (evcoll.h)

La funzione EcGetSubscriptionProperty recupera un valore di proprietà specifico da un oggetto sottoscrizione. L'oggetto sottoscrizione viene specificato dall'handle passato al parametro Subscription .

Sintassi

BOOL EcGetSubscriptionProperty(
  [in]  EC_HANDLE                   Subscription,
  [in]  EC_SUBSCRIPTION_PROPERTY_ID PropertyId,
  [in]  DWORD                       Flags,
  [in]  DWORD                       PropertyValueBufferSize,
  [in]  PEC_VARIANT                 PropertyValueBuffer,
  [out] PDWORD                      PropertyValueBufferUsed
);

Parametri

[in] Subscription

Handle per l'oggetto sottoscrizione.

[in] PropertyId

Identificatore che specifica la proprietà della sottoscrizione da ottenere. Specificare un valore dall'enumerazione EC_SUBSCRIPTION_PROPERTY_ID . Se si specifica il valore EcSubscriptionEventSources , verrà restituito un handle a una matrice (EC_OBJECT_ARRAY_PROPERTY_HANDLE). È quindi possibile usare le funzioni EcGetObjectArrayProperty e EcSetObjectArrayProperty per ottenere e impostare le proprietà Address, Enabled, UserName e Password nella matrice.

[in] Flags

Riservato. Deve essere NULL.

[in] PropertyValueBufferSize

Dimensioni del buffer fornito dall'utente in cui archiviare il valore della proprietà.

[in] PropertyValueBuffer

Buffer fornito dall'utente in cui archiviare il valore della proprietà.

[out] PropertyValueBufferUsed

Dimensioni del buffer fornito dall'utente che viene utilizzato dalla funzione in caso di esito positivo restituito o dimensioni necessarie per archiviare il valore della proprietà quando la funzione ha esito negativo con ERROR_INSUFFICIENT_BUFFER.

Valore restituito

Questa funzione restituisce BOOL.

Requisiti

Vedi anche

Funzioni dell'agente di raccolta eventi Windows