estructura PDH_BROWSE_DLG_CONFIG_HA (pdh.h)
La estructura
Sintaxis
typedef struct _BrowseDlgConfig_HA {
DWORD bIncludeInstanceIndex : 1;
DWORD bSingleCounterPerAdd : 1;
DWORD bSingleCounterPerDialog : 1;
DWORD bLocalCountersOnly : 1;
DWORD bWildCardInstances : 1;
DWORD bHideDetailBox : 1;
DWORD bInitializePath : 1;
DWORD bDisableMachineSelection : 1;
DWORD bIncludeCostlyObjects : 1;
DWORD bShowObjectBrowser : 1;
DWORD bReserved : 22;
HWND hWndOwner;
PDH_HLOG hDataSource;
LPSTR szReturnPathBuffer;
DWORD cchReturnPathLength;
CounterPathCallBack pCallBack;
DWORD_PTR dwCallBackArg;
PDH_STATUS CallBackStatus;
DWORD dwDefaultDetailLevel;
LPSTR szDialogBoxCaption;
} PDH_BROWSE_DLG_CONFIG_HA, *PPDH_BROWSE_DLG_CONFIG_HA;
Miembros
bIncludeInstanceIndex
Si esta marca es TRUE, el cuadro de diálogo incluye un número de índice para los nombres de instancia duplicados. Por ejemplo, si hay dos instancias cmd, la lista de instancias contendrá cmd y cmd#1. Si esta marca es FALSE, los nombres de instancia duplicados no contendrán un número de índice.
bSingleCounterPerAdd
Si esta marca es TRUE, el cuadro de diálogo devuelve solo un contador. Si esta marca es FALSE, el cuadro de diálogo puede devolver varias selecciones y se permiten selecciones comodín. Los contadores seleccionados se devuelven como una cadena MULTI_SZ.
bSingleCounterPerDialog
Si esta marca es TRUE, el cuadro de diálogo usa un botón Aceptar y Cancelar. El cuadro de diálogo devuelve cuando el usuario hace clic en cualquiera de los botones. Si esta marca es FALSE, el cuadro de diálogo usa un botón Agregar y cerrar. El cuadro de diálogo se cierra cuando el usuario hace clic en el botón Cerrar. El botón Agregar se puede hacer clic varias veces. El botón Agregar sobrescribe los elementos seleccionados anteriormente con los elementos seleccionados actualmente.
bLocalCountersOnly
Si esta marca es TRUE, el cuadro de diálogo permite al usuario seleccionar contadores solo desde el equipo local (la ruta de acceso no contendrá un nombre de equipo). Si esta marca es FALSE, el usuario puede especificar un equipo desde el que seleccionar contadores. El nombre del equipo prefijo la ruta de acceso del contador a menos que el usuario seleccione Usar contadores de equipo local.
bWildCardInstances
Si esta marca es TRUE y el usuario selecciona Todas las instancias, la ruta de acceso del contador incluirá el carácter comodín para el campo de instancia.
Si esta marca es FALSEy el usuario selecciona Todas las instancias, todas las instancias que se encuentran actualmente para ese objeto se devolverán en una cadena de MULTI_SZ.
bHideDetailBox
Si esta marca es TRUE, se quita nivel de detalle del cuadro de diálogo para que el usuario no pueda cambiar el nivel de detalle de los contadores mostrados en el cuadro de diálogo. El nivel de detalle se fijará en el valor del miembro dwDefaultDetailLevel.
Si esta marca es FALSE, se muestra nivel de detalle en el cuadro de diálogo, lo que permite al usuario cambiar el nivel de detalle de los contadores mostrados.
Tenga en cuenta que los contadores mostrados serán aquellos cuyo nivel de detalle sea menor o igual que la selección del nivel de detalle actual. Al seleccionar un nivel de detalle del Asistente se mostrarán todos los contadores y objetos.
bInitializePath
Si esta marca es TRUE, el cuadro de diálogo resalta el contador y el objeto especificados en szReturnPathBuffer cuando se muestra el cuadro de diálogo por primera vez, en lugar de usar el contador y el objeto predeterminados especificados por el equipo.
Si esta marca es FALSE, selecciona el contador inicial y el objeto mediante el contador predeterminado y la información del objeto devueltos por el equipo.
bDisableMachineSelection
Si esta marca es TRUE, el usuario no puede seleccionar un equipo en Seleccionar contadores del equipo.
Si esta marca es FALSE, el usuario puede seleccionar un equipo en Seleccionar contadores del equipo. Este es el valor predeterminado.
La lista contiene el equipo local solo a menos que llame primero al PdhConnectMachine
bIncludeCostlyObjects
Si esta marca es TRUE, la lista de contadores también contendrá datos costosos, es decir, los datos que requieren una cantidad relativamente grande de tiempo de procesador o sobrecarga de memoria para recopilar.
Si esta marca es FALSE, la lista no contendrá contadores costosos. Este es el valor predeterminado.
bShowObjectBrowser
Si esta marca es TRUE, el cuadro de diálogo muestra solo los objetos de rendimiento. Cuando el usuario selecciona un objeto, el cuadro de diálogo devuelve una ruta de acceso de contador que incluye el objeto y los caracteres comodín para el nombre de instancia y el contador si el objeto es un objeto de varias instancias. Por ejemplo, si se selecciona el objeto "Process", el cuadro de diálogo devuelve la cadena "\Process(*)*". Si el objeto es un solo objeto de instancia, la ruta de acceso contiene un carácter comodín solo para contador. Por ejemplo, "\System*". A continuación, puede pasar la ruta de acceso a PdhExpandWildCardPath para recuperar una lista de rutas de acceso reales para el objeto.
bReserved
hWndOwner
Identificador de la ventana para poseer el cuadro de diálogo. Si null, el propietario es el escritorio.
hDataSource
Controle un origen de datos devuelto por la función
szReturnPathBuffer
Puntero a un MULTI_SZ que contiene las rutas de acceso de contador seleccionadas.
Si bInitializePath es TRUE, puede usar este miembro para especificar una ruta de acceso de contador cuyos componentes se usan para resaltar entradas en las listas de equipos, objetos, contadores e instancias cuando se muestra el cuadro de diálogo por primera vez.
cchReturnPathLength
Tamaño del búfer de szReturnPathBuffer, en TCHAR. Si la función de devolución de llamada reasigna un nuevo búfer, también debe actualizar este valor.
pCallBack
Puntero a la función de devolución de llamada que procesa la selección del usuario. Para obtener más información, vea CounterPathCallBack.
dwCallBackArg
Valor definido por el autor de la llamada que se pasa a la función de devolución de llamada.
CallBackStatus
En la entrada a la función de devolución de llamada, este miembro contiene el estado del búfer de ruta de acceso. Al salir, la función de devolución de llamada establece el valor de estado resultante del procesamiento.
Si el búfer es demasiado pequeño para cargar la selección actual, el cuadro de diálogo establece este valor en PDH_MORE_DATA. Si este valor es ERROR_SUCCESS, el szReturnPathBuffer miembro contiene una ruta de acceso de contador o una lista de rutas de acceso de contador válidas.
Si la función de devolución de llamada reasigna un nuevo búfer, debe establecer este miembro en PDH_RETRY para que el cuadro de diálogo intente cargar el búfer con las rutas de acceso seleccionadas y vuelva a llamar a la función de devolución de llamada.
Si se produjo algún otro error, la función de devolución de llamada debe devolver el valor de estado de error PDH adecuado.
dwDefaultDetailLevel
Nivel de detalle predeterminado que se muestra en la lista nivel de detalle de
szDialogBoxCaption
Puntero a un cadena terminada en nullque especifica el título opcional que se va a mostrar en la barra de subtítulos del cuadro de diálogo. Si este miembro es null, el título se Examinar contadores de rendimiento.
Observaciones
Cada vez que se hace clic en el botón Agregar
Nota
El encabezado pdh.h define PDH_BROWSE_DLG_CONFIG_H como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows XP [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| encabezado de |
pdh.h |