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 |