Función EcGetObjectArrayProperty (evcoll.h)

La función EcGetObjectArrayProperty recupera los valores de propiedad de un identificador a una matriz de propiedades de origen de eventos. La matriz contiene valores de propiedad para los orígenes de eventos de una suscripción.

Sintaxis

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
);

Parámetros

[in] ObjectArray

Identificador de una matriz de propiedades para los orígenes de eventos de una suscripción. Identificador de matriz devuelto por el método EcGetSubscriptionProperty cuando el valor EcSubscriptionEventSources se pasa al parámetro PropertyId .

[in] PropertyId

Identificador de propiedad de las propiedades de la matriz. Especifique un valor de la enumeración EC_SUBSCRIPTION_PROPERTY_ID . Obtenga las propiedades Address, Enabled, UserName y Password de la matriz especificando los valores EcSubscriptionEventSourceAddress, EcSubscriptionEventSourceEnabled, EcSubscriptionEventSourceUserName o EcSubscriptionEventSourcePassword .

[in] ArrayIndex

Índice de la matriz que especifica el origen del evento del que se va a obtener la propiedad .

[in] Flags

Reservado. Debe ser 0.

[in] PropertyValueBufferSize

Tamaño del búfer que contiene el valor de la propiedad . El tamaño debe ser al menos el tamaño de un valor de EC_VARIANT .

[in] PropertyValueBuffer

Búfer proporcionado por el usuario en el que se almacenará el valor de propiedad.

[out] PropertyValueBufferUsed

Tamaño del búfer proporcionado por el usuario que usa la función en la devolución correcta, o el tamaño necesario para almacenar el valor de propiedad cuando se produce un error en la función con ERROR_INSUFFICIENT_BUFFER.

Valor devuelto

Esta función devuelve BOOL.

Comentarios

Las matrices son de base cero, por lo que el índice del primer elemento de la matriz es 0.

No se puede recuperar la propiedad Password de un origen de eventos o la suscripción. Por motivos de seguridad, se devuelve una cadena vacía para el valor de propiedad y el último error se establecerá en ERROR_ACCESS_DENIED.

Una suscripción puede tener varios orígenes de eventos y cada origen puede tener una propiedad Address, Enabled, UserName y Password .

Ejemplos

Para obtener código de ejemplo con la función EcGetObjectArrayProperty , vea Mostrar las propiedades de una suscripción del recopilador de eventos.

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