PDH_BROWSE_DLG_CONFIG_A estructura (pdh.h)
La función PdhBrowseCounters usa la estructura PDH_BROWSE_DLG_CONFIG para configurar el cuadro de diálogo Examinar contadores de rendimiento.
Sintaxis
typedef struct _BrowseDlgConfig_A {
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;
LPSTR szDataSource;
LPSTR szReturnPathBuffer;
DWORD cchReturnPathLength;
CounterPathCallBack pCallBack;
DWORD_PTR dwCallBackArg;
PDH_STATUS CallBackStatus;
DWORD dwDefaultDetailLevel;
LPSTR szDialogBoxCaption;
} PDH_BROWSE_DLG_CONFIG_A, *PPDH_BROWSE_DLG_CONFIG_A;
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 de 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 de 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 se 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 FALSE y el usuario selecciona Todas las instancias, todas las instancias que se encuentran actualmente para ese objeto se devolverán en una cadena MULTI_SZ.
bHideDetailBox
Si esta marca es TRUE, quita el 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 el 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 por primera vez el cuadro de diálogo, en lugar de usar el contador predeterminado y el objeto especificado por el equipo.
Si esta marca es FALSE, selecciona el contador inicial y el objeto mediante el contador predeterminado y la información de objeto devuelta 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 a PdhConnectMachine para conectarse primero a otros equipos.
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 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 instancia múltiple. Por ejemplo, si se selecciona el objeto "Process", el cuadro de diálogo devuelve la cadena "\Process(*)*". Si el objeto es un único objeto de instancia, la ruta de acceso contiene un carácter comodín solo para el 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 es NULL, el propietario es el escritorio.
szDataSource
Puntero a una cadena terminada en null que especifica el nombre del archivo de registro desde el que se recupera la lista de contadores. Si es NULL, la lista de contadores se recupera del equipo local (o equipo remoto si se especifica).
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 las entradas del equipo, el objeto, el contador y las listas de instancias cuando se muestra el cuadro de diálogo por primera vez.
cchReturnPathLength
Tamaño del búfer 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 miembro szReturnPathBuffer contiene una ruta de acceso de contador válida o una lista de rutas de acceso del contador.
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 volver 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 mostrará en la lista Nivel de detalle si bHideDetailBox es FALSE. Si bHideDetailBox es TRUE, el cuadro de diálogo usa este valor para filtrar los contadores de rendimiento y los objetos mostrados. Puede especificar uno de los siguientes valores:
szDialogBoxCaption
Puntero a una cadena terminada en null que especifica el subtítulo opcional que se va a mostrar en la barra de subtítulo del cuadro de diálogo. Si este miembro es NULL, el subtítulo será Examinar contadores de rendimiento.
Comentarios
Cada vez que se hace clic en el botón Agregar , el búfer szReturnPathBuffer contiene el contador seleccionado y se llama a la función de devolución de llamada pCallBack . La función de devolución de llamada debe llamar a la función PdhAddCounter para cada contador del búfer.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado | pdh.h |