217 lines
10 KiB
Plaintext
217 lines
10 KiB
Plaintext
Attribute VB_Name = "PDH Definitions"
|
||
'
|
||
'
|
||
' Visual Basic 4.0 definitions file for use with
|
||
' PDH.DLL the Peformance Data Helper DLL
|
||
'
|
||
' Copyright (c) 1996-1999 by Microsoft Corporation
|
||
'
|
||
' 19-Apr-1996 Bob Watson
|
||
'
|
||
' = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
|
||
'
|
||
' Pdh Error status return values
|
||
'
|
||
Public Const ERROR_SUCCESS = 0
|
||
Public Const PDH_CSTATUS_VALID_DATA = &H20000000
|
||
Public Const PDH_CSTATUS_NEW_DATA = &H20000001
|
||
Public Const PDH_CSTATUS_NO_MACHINE = &HA00007D0
|
||
Public Const PDH_CSTATUS_NO_INSTANCE = &HA00007D1
|
||
Public Const PDH_MORE_DATA = &HA00007D2
|
||
Public Const PDH_CSTATUS_ITEM_NOT_VALIDATED = &HA00007D3
|
||
Public Const PDH_RETRY = &HA00007D4
|
||
Public Const PDH_NO_DATA = &HA00007D5
|
||
Public Const PDH_CALC_NEGATIVE_DENOMINATOR = &HA00007D6
|
||
Public Const PDH_CALC_NEGATIVE_TIMEBASE = &HA00007D7
|
||
Public Const PDH_CALC_NEGATIVE_VALUE = &HA00007D8
|
||
Public Const PDH_DIALOG_CANCELLED = &HA00007D9
|
||
Public Const PDH_CSTATUS_NO_OBJECT = &HE0000BB8
|
||
Public Const PDH_CSTATUS_NO_COUNTER = &HE0000BB9
|
||
Public Const PDH_CSTATUS_INVALID_DATA = &HE0000BBA
|
||
Public Const PDH_MEMORY_ALLOCATION_FAILURE = &HE0000BBB
|
||
Public Const PDH_INVALID_HANDLE = &HE0000BBC
|
||
Public Const PDH_INVALID_ARGUMENT = &HE0000BBD
|
||
Public Const PDH_FUNCTION_NOT_FOUND = &HE0000BBE
|
||
Public Const PDH_CSTATUS_NO_COUNTERNAME = &HE0000BBF
|
||
Public Const PDH_CSTATUS_BAD_COUNTERNAME = &HE0000BC0
|
||
Public Const PDH_INVALID_BUFFER = &HE0000BC1
|
||
Public Const PDH_INSUFFICIENT_BUFFER = &HE0000BC2
|
||
Public Const PDH_CANNOT_CONNECT_MACHINE = &HE0000BC3
|
||
Public Const PDH_INVALID_PATH = &HE0000BC4
|
||
Public Const PDH_INVALID_INSTANCE = &HE0000BC5
|
||
Public Const PDH_INVALID_DATA = &HE0000BC6
|
||
Public Const PDH_NO_DIALOG_DATA = &HE0000BC7
|
||
Public Const PDH_CANNOT_READ_NAME_STRINGS = &HE0000BC8
|
||
'
|
||
' Counter Browser Detail Level Definitions
|
||
'
|
||
Public Const PERF_DETAIL_NOVICE = 100
|
||
Public Const PERF_DETAIL_ADVANCED = 200
|
||
Public Const PERF_DETAIL_EXPERT = 300
|
||
Public Const PERF_DETAIL_WIZARD = 400
|
||
'
|
||
' Standard PDH Function prototypes
|
||
'
|
||
Public Declare Function PdhOpenQuery Lib "Pdh.Dll" Alias "PdhVbOpenQuery" ( _
|
||
ByRef QueryHandle As Long) As Long
|
||
'
|
||
' PdhOpenQuery Creates an empty performance data query structure
|
||
' QueryHandle The Id of the query created is returned in this buffer
|
||
' Return Value an error code from the list above. ERROR_SUCCESS
|
||
' indicates a valid query was created and
|
||
' the value returned in QueryHandle is valid
|
||
'
|
||
Public Declare Function PdhAddCounter Lib "Pdh.Dll" Alias "PdhVbAddCounter" ( _
|
||
ByVal QueryHandle As Long, _
|
||
ByVal CounterPath As String, _
|
||
ByRef CounterHandle As Long) As Long
|
||
'
|
||
' PdhAddCounter Adds a counter to the specified query
|
||
' QueryHandle the QueryHandle of the query to add the counter to.
|
||
' This is the value initialized by the PdhOpenQuery
|
||
' function
|
||
' CounterPath the counter path string of the counter to add. This
|
||
' value can be obtained by either the
|
||
' PdhGetOneCounterPath or the PdhCreateCounterPathList
|
||
' functions
|
||
' CounterHandle The handle to the counter that is added to the query
|
||
' Return Value an error code from the list above. ERROR_SUCCESS
|
||
' indicates a valid counter was created
|
||
'
|
||
Public Declare Function PdhRemoveCounter Lib "Pdh.Dll" ( _
|
||
ByVal CounterHandle As Long) As Long
|
||
'
|
||
' PdhRemoveCounter Removes the specified counter from the query to which
|
||
' it belongs
|
||
' CounterHandle Handle of the counter to remove
|
||
' Return Value an error code from the list above. ERROR_SUCCESS
|
||
' indicates the counter was removed
|
||
'
|
||
Public Declare Function PdhCollectQueryData Lib "Pdh.Dll" ( _
|
||
ByVal QueryHandle As Long) As Long
|
||
'
|
||
' PdhCollectQueryData Obtains the current values of each counter in the
|
||
' query (the value of each counter must be retrieved
|
||
' individually using the PdhGetDoubleCounterValue,
|
||
' after the data has been updated)
|
||
' QueryHandle Handle of the query to refresh
|
||
' Return Value an error code from the list above. ERROR_SUCCESS
|
||
' indicates the function completed successfully
|
||
'
|
||
Public Declare Function PdhCloseQuery Lib "Pdh.Dll" ( _
|
||
ByVal QueryHandle As Long) As Long
|
||
'
|
||
' PdhCloseQuery Terminates data collection and frees the resources
|
||
' associated with the query
|
||
' QueryHandle Handle of query to close and free
|
||
' Return Value an error code from the list above. ERROR_SUCCESS
|
||
' indicates the query was freed
|
||
'
|
||
' = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
|
||
'
|
||
' DPH VB Helper Functions
|
||
'
|
||
Public Declare Function PdhGetDoubleCounterValue Lib "Pdh.Dll" _
|
||
Alias "PdhVbGetDoubleCounterValue" ( _
|
||
ByVal CounterHandle As Long, _
|
||
ByRef CounterStatus As Long) As Double
|
||
'
|
||
' PdhGetDoubleCounterValue retrieves the value of the specified counter
|
||
' as a double precision real number
|
||
' CounterHandle The handle of the counter to retrive
|
||
' CounterStatus returns the current status of the counter
|
||
' as a PDH_ status value defined above
|
||
' Return Value The double precision real value of the counter
|
||
'
|
||
Public Declare Function PdhGetOneCounterPath Lib "Pdh.Dll" _
|
||
Alias "PdhVbGetOneCounterPath" ( _
|
||
ByVal PathString As String, _
|
||
ByVal PathLength As Long, _
|
||
ByVal DetailLevel As Long, _
|
||
ByVal CaptionString As String) As Long
|
||
'
|
||
' PdhGetOneCounterPath Displays a dialog box prompting the user to
|
||
' select one counter path
|
||
' PathString Preinitialized buffer to retrieve the path string
|
||
' PathLength Sise of initialized buffer
|
||
' DetailLevel Level of detail to filter counter display. 0
|
||
' shows all counters and hides detail combo
|
||
' box.
|
||
' CaptionString String to display in caption bar of browser
|
||
' dialog box
|
||
' Return Value returns the number of characters written to the
|
||
' PathString buffer.
|
||
'
|
||
Public Declare Function PdhCreateCounterPathList Lib "Pdh.Dll" _
|
||
Alias "PdhVbCreateCounterPathList" ( _
|
||
ByVal DetailLevel As Long, _
|
||
ByVal CaptionString As String) As Long
|
||
'
|
||
' PdhCreateCounterPathList Displays a dialog box prompting the user to
|
||
' select multiple counters Use the next
|
||
' function to read the selected path strings
|
||
' DetailLevel Level of detail to filter counter display. 0
|
||
' shows all counters and hides detail combo
|
||
' box.
|
||
' CaptionString String to display in caption bar of browser
|
||
' dialog box
|
||
' Return Value returns the number of path strings selected
|
||
'
|
||
Public Declare Function PdhGetCounterPathFromList Lib "Pdh.Dll" _
|
||
Alias "PdhVbGetCounterPathFromList" ( _
|
||
ByVal Index As Long, _
|
||
ByVal Buffer As String, _
|
||
ByVal BufferLength As Long) _
|
||
As Long
|
||
'
|
||
' PdhGetCounterPathFromList Retrieves an individual path string from the
|
||
' list created by the PdhCreateCounterPathList
|
||
' function call
|
||
' Index Index of the path string to retrieve starting
|
||
' at 1 and going to the value returned by
|
||
' the previous call to PdhCreateCounterPathList
|
||
' Buffer An initialized string buffer to retrieve the
|
||
' selected string
|
||
' BufferLength The maximum size of the buffer
|
||
' Return Value The number of characters copied to Buffer
|
||
'
|
||
'
|
||
Public Declare Function PdhGetCounterPathElements Lib "Pdh.Dll" _
|
||
Alias "PdhVbGetCounterPathElements" ( _
|
||
ByVal PathString As String, _
|
||
ByVal MachineName As String, _
|
||
ByVal ObjectName As String, _
|
||
ByVal InstanceName As String, _
|
||
ByVal ParentInstance As String, _
|
||
ByVal CounterName As String, _
|
||
ByVal BufferSize As Long) As Long
|
||
'
|
||
' PdhGetCounterPathElements Reads a performance counter path
|
||
' string and returns the components
|
||
' as individual strings
|
||
' PathString The full path string to read
|
||
' MachineName The buffer to receive the machine name
|
||
' ObjectName The buffer to receive the object name
|
||
' InstanceName The buffer to receive the instance name
|
||
' ParentInstance The buffer to receive the parent instance
|
||
' CounterName The buffer to receive the counter name
|
||
' BufferSize The size of the string buffers
|
||
'
|
||
' ReturnValue DPH status code. 0 means the function succeeded.
|
||
'
|
||
'
|
||
Public Declare Function PdhIsGoodStatus Lib "Pdh.Dll" _
|
||
Alias "PdhVbIsGoodStatus" ( _
|
||
ByVal StatusValue As Long ) As Long
|
||
'
|
||
' PdhIsGoodStatus tests the status value returned by a PDH function
|
||
' to determine if the function or value returned
|
||
' is good/success (nozero) or bad/error (zero)
|
||
'
|
||
' StatusValue the value returned by a call to a PDH function
|
||
'
|
||
' Return Value 0 if the status is not good
|
||
' non-zero if the status is good
|
||
'
|
||
'END OF PdhDefs.TXT
|
||
|