pdhExpandWildCardPathHW 函式 (pdh.h)

檢查指定的計算機或記錄檔，並傳回符合包含通配符之指定計數器路徑的計數器路徑。

此函式與 PdhExpandWildCardPath 函式相同，不同之處在於它支援使用數據源的句柄。

語法

PDH_FUNCTION PdhExpandWildCardPathHW(
  [in]      PDH_HLOG hDataSource,
  [in]      LPCWSTR  szWildCardPath,
  [out]     PZZWSTR  mszExpandedPathList,
  [in, out] LPDWORD  pcchPathListLength,
  [in]      DWORD    dwFlags
);

參數

[in] hDataSource

PdhBindInputDataSource 函式所傳回數據源的句柄。

[in] szWildCardPath

以 Null 結束的字串，指定要展開的計數器路徑。 計數器路徑的最大長度是PDH_MAX_COUNTER_PATH。

如果 hDataSource 是即時數據源，函式會在路徑中指定的電腦搜尋相符專案。 如果路徑未指定計算機，函式會搜尋本機計算機。

[out] mszExpandedPathList

呼叫端配置的緩衝區，接收符合 szWildCardPath 中通配符規格的 Null 終止計數器路徑清單。 清單會以兩 個NULL 字元終止。 如果pcchPathListLength為零，則設定為NULL。

[in, out] pcchPathListLength

mszExpandedPathList 緩衝區的大小，以 TCHAR 為單位。 如果輸入和物件存在零，函式會傳回PDH_MORE_DATA，並將此參數設定為所需的緩衝區大小。 如果緩衝區大於所需的大小，函式會將此參數設定為所使用緩衝區的實際大小。 如果輸入上的指定大小大於零，但小於所需的大小，您就不應該依賴傳回的大小來重新配置緩衝區。

[in] dwFlags

旗標，指出要展開的通配符。 您可以指定一或多個旗標。

傳回值

如果函式成功，則會傳回ERROR_SUCCESS。

如果函式失敗，傳回值為 系統錯誤碼 或 PDH 錯誤碼。

備註

您應該呼叫此函式兩次，第一次取得所需的緩衝區大小， (將 mszExpandedPathList 設定為 NULL ， 並將 pcchPathListLength 設定為 0) ，第二次取得數據。

PdhExpandWildCardPathH 與 PdhExpandCounterPath 有下列不同之處：

1. 可讓您控制要展開的通配符。
2. 記錄檔的內容可作為計數器名稱的來源。

\computer\object (parent/instance#index) \counter

計數器路徑的父系、實例、索引和計數器元件可能包含有效的名稱或通配符。 所有計數器都不需要計算機、父系、實例和索引元件。

以下是可能的格式清單：

• \\computer\object (parent/instance#index) \counter
• \\computer\object (父/實例) \counter
• \\computer\object (instance#index) \counter
• \\computer\object (實例) \counter
• \\computer\object\counter
• \object (parent/instance#index) \counter
• \object (父/實例) \counter
• \object (instance#index) \counter
• \object (實例) \counter
• \object\counter

如果在父名稱中指定通配符，則會傳回符合指定實例和計數器欄位之指定物件的所有實例。 例如，\object (*/instance) \counter。

如果在實例名稱中指定通配符，如果對應至指定索引的所有實例名稱符合通配符，則會傳回指定物件和父物件的所有實例。 例如，\object (parent/*) \counter。

如果在計數器名稱中指定通配符，則會傳回指定物件的所有計數器。

部分計數器路徑字串符合 (例如，支援 “pro*”) 。

在 Windows Vista 之前： 不支援部分通配符比對。

規格需求

另請參閱

PdhBindInputDataSourceA 函式

PdhEnumObjectItemsHA 函式

PdhEnumObjectsHA 函式

PdhExpandWildCardPathW 函式