PdhValidatePath
The PdhValidatePath function validates that the specified counter is present on the machine specified in the counter path.
PDH_STATUS PdhValidatePath(
IN LPCTSTR szFullCounterPath // counter path to validate
);
Parameters
-
szFullCounterPath
-
The counter path to validate.
Return Values
If the function succeeds, it returns ERROR_SUCCESS.
If the function fails, the return value is a PDH error status defined in pdhmsg.h. The following are possible error values:
-
PDH_CSTATUS_NO_INSTANCE
-
The specified instance of the performance object was not found.
-
PDH_CSTATUS_NO_COUNTER
-
The specified counter was not found in the performance object.
-
PDH_CSTATUS_NO_OBJECT
-
The specified performance object was not found on the machine.
-
PDH_CSTATUS_NO_MACHINE
-
The specified machine could not be found or connected to.
-
PDH_CSTATUS_BAD_COUNTERNAME
-
The counter path string could not be parsed.
-
PDH_MEMORY_ALLOCATION_FAILURE
-
The function is unable to allocate a required temporary buffer.
See Also
Performance Data Helper Overview, Performance Data Functions, , PdhMakeCounterPath