Export (0) Print
Expand All
Expand Minimize

PdhValidatePath function

Validates that the counter is present on the computer specified in the counter path.

Syntax


PDH_STATUS PdhValidatePath(
  _In_  LPCTSTR szFullCounterPath
);

Parameters

szFullCounterPath [in]

Null-terminated string that contains the counter path to validate. The maximum length of a counter path is PDH_MAX_COUNTER_PATH.

Return value

If the function succeeds, it returns ERROR_SUCCESS.

If the function fails, the return value is a system error code or a PDH error code. The following are possible values.

Return codeDescription
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 computer.

PDH_CSTATUS_NO_MACHINE

The specified computer 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.

 

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Pdh.h

Library

Pdh.lib

DLL

Pdh.dll

Unicode and ANSI names

PdhValidatePathW (Unicode) and PdhValidatePathA (ANSI)

See also

PdhMakeCounterPath

 

 

Community Additions

ADD
Show:
© 2015 Microsoft