Compartir a través de

Función PdhCloseQuery (pdh.h)

  • Artículo

Cierra todos los contadores contenidos en la consulta especificada, cierra todos los identificadores relacionados con la consulta y libera toda la memoria asociada a la consulta.

Sintaxis

PDH_FUNCTION PdhCloseQuery(
  [in] PDH_HQUERY hQuery
);

Parámetros

[in] hQuery

Identificador de la consulta que se va a cerrar. La función PdhOpenQuery devuelve este identificador.

Valor devuelto

Si la función se ejecuta correctamente, devuelve ERROR_SUCCESS. De lo contrario, la función devuelve un código de error del sistema o un código de error PDH.

A continuación se muestra un valor posible.

Código devuelto Descripción
PDH_INVALID_HANDLE
 El identificador de consulta no es válido.

Comentarios

No use los identificadores de contador asociados a esta consulta después de llamar a esta función.

A continuación se muestra la sintaxis si se llama a esta función desde Visual Basic.

PdhCloseQuery(
  ByVal QueryHandle as Long  
)
as Long

Ejemplos

Para obtener un ejemplo, vea Examinar contadores de rendimiento o leer datos de rendimiento desde un archivo de registro.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado pdh.h
Library Pdh.lib
Archivo DLL Pdh.dll

Consulte también

PdhOpenQuery