Share via

Función PdhConnectMachineW (pdh.h)

  • Artículo

Se conecta al equipo especificado.

Sintaxis

PDH_FUNCTION PdhConnectMachineW(
  [in] LPCWSTR szMachineName
);

Parámetros

[in] szMachineName

Cadena terminada en NULL que especifica el nombre del equipo al que se va a conectar. Si es NULL, PDH se conecta al equipo local.

Valor devuelto

Si la función se ejecuta correctamente, devuelve ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código de error del sistema o un código de error PDH. A continuación se muestran los valores posibles.

Código devuelto Descripción
PDH_CSTATUS_NO_MACHINE
 No se puede conectar al equipo especificado. Podría deberse a que el equipo no está activado, no admite PDH, no está conectado a la red o tiene los permisos establecidos en el registro que impiden las conexiones remotas o la supervisión remota del rendimiento por parte del usuario.
PDH_MEMORY_ALLOCATION_FAILURE
 No se puede asignar un bloque de memoria dinámica. Se produce cuando hay una escasez grave de memoria en el sistema debido a demasiadas aplicaciones que se ejecutan en el sistema o a un archivo de paginación de memoria insuficiente.

Comentarios

Normalmente, las aplicaciones no llaman a esta función y, en su lugar, la conexión se realiza cuando la aplicación agrega el contador a la consulta.

Sin embargo, puede usar esta función si desea incluir más que el equipo local en la lista Seleccionar contadores del equipo en el cuadro de diálogo Examinar contadores . Para más información, consulte la estructura PDH_BROWSE_DLG_CONFIG .

Nota

El encabezado pdh.h define PdhConnectMachine 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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

PdhEnumMachines