Funzione EcGetObjectArrayProperty (evcoll.h)

La funzione EcGetObjectArrayProperty recupera i valori delle proprietà da un handle a una matrice di proprietà dell'origine evento. La matrice contiene valori di proprietà per le origini eventi di una sottoscrizione.

Sintassi

BOOL EcGetObjectArrayProperty(
  [in]  EC_OBJECT_ARRAY_PROPERTY_HANDLE ObjectArray,
  [in]  EC_SUBSCRIPTION_PROPERTY_ID     PropertyId,
  [in]  DWORD                           ArrayIndex,
  [in]  DWORD                           Flags,
  [in]  DWORD                           PropertyValueBufferSize,
  [in]  PEC_VARIANT                     PropertyValueBuffer,
  [out] PDWORD                          PropertyValueBufferUsed
);

Parametri

[in] ObjectArray

Handle a una matrice di proprietà per le origini eventi per una sottoscrizione. Handle di matrice restituito dal metodo EcGetSubscriptionProperty quando il valore EcSubscriptionEventSources viene passato al parametro PropertyId .

[in] PropertyId

Identificatore della proprietà per le proprietà nella matrice. Specificare un valore dall'enumerazione EC_SUBSCRIPTION_PROPERTY_ID . Ottenere le proprietà Address, Enabled, UserName e Password nella matrice specificando i valori EcSubscriptionEventSourceAddress, EcSubscriptionEventSourceEnabled, EcSubscriptionEventSourceUserName o EcSubscriptionEventscriptionEventSourcePassword .

[in] ArrayIndex

Indice della matrice che specifica l'origine evento da cui ottenere la proprietà.

[in] Flags

Riservato. Deve essere 0.

[in] PropertyValueBufferSize

Dimensione del buffer contenente il valore della proprietà. Le dimensioni devono essere almeno le dimensioni di un valore EC_VARIANT .

[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.

Commenti

Le matrici sono basate su zero, quindi l'indice per il primo elemento della matrice è 0.

Impossibile recuperare la proprietà Password per un'origine evento o la sottoscrizione. Per motivi di sicurezza, viene restituita una stringa vuota per il valore della proprietà e l'ultimo errore verrà impostato su ERROR_ACCESS_DENIED.

Una sottoscrizione può avere più origini eventi e ogni origine può avere una proprietà Address, Enabled, UserName e Password .

Esempio

Ad esempio, il codice che usa la funzione EcGetObjectArrayProperty , vedere Visualizzazione delle proprietà di una sottoscrizione dell'agente di raccolta eventi.

Requisiti

Vedi anche

Funzioni dell'agente di raccolta eventi Windows