共用方式為

PdhExpandWildCardPathHA 函式 （pdh.h）

  • 發行項

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

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

語法

PDH_FUNCTION PdhExpandWildCardPathHA(
  [in]      PDH_HLOG hDataSource,
  [in]      LPCSTR   szWildCardPath,
  [out]     PZZSTR   mszExpandedPathList,
  [in, out] LPDWORD  pcchPathListLength,
  [in]      DWORD    dwFlags
);

參數

[in] hDataSource

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

[in] szWildCardPath

Null-terminated 字串，指定要展開的計數器路徑。 計數器路徑的最大長度為 PDH_MAX_COUNTER_PATH。

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

[out] mszExpandedPathList

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

[in, out] pcchPathListLength

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

注意 您必須將一個新增至 Windows XP 上所需的大小。
 

[in] dwFlags

表示要展開之通配符的旗標。 您可以指定一或多個旗標。

價值 意義
PDH_NOEXPANDCOUNTERS
 如果路徑包含計數器名稱的通配符，請勿展開計數器名稱。
PDH_NOEXPANDINSTANCES
 如果路徑包含父實例、實例名稱或實例索引的通配符，請勿展開實例名稱。
PDH_REFRESHCOUNTERS
 重新整理計數器清單。

傳回值

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

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

傳回碼 描述
PDH_MORE_DATA
 mszExpandedPathList 緩衝區不夠大，無法包含路徑清單。 如果輸入時 pcchPathListLength 為零，則應該傳回值。 如果輸入上的指定大小大於零，但小於所需的大小，則不應該依賴傳回的大小來重新配置緩衝區。
PDH_INVALID_ARGUMENT
 參數無效。 例如，在某些版本中，如果輸入上的指定大小大於零，但小於所需的大小，您可能會收到此錯誤。
PDH_MEMORY_ALLOCATION_FAILURE
 無法配置記憶體以支援此函式。
PDH_CSTATUS_NO_OBJECT
 在電腦或記錄檔中找不到指定的物件。

言論

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

PdhExpandWildCardPathH 與 PdhExpandCounterPath 的方式不同：

  1. 可讓您控制要展開的通配符。
  2. 記錄檔的內容可以做為計數器名稱的來源。
一般計數器路徑格式如下所示：

\computer\object（parent/instance#index）\counter

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

以下是可能格式的清單：

  • \\computer\object（parent/instance#index）\counter
  • \\computer\object（parent/instance）\counter
  • \\computer\object（instance#index）\counter
  • \\computer\object（instance）\counter
  • \\computer\object\counter
  • \object（parent/instance#index）\counter
  • \object（parent/instance）\counter
  • \object（instance#index）\counter
  • \object（instance）\counter
  • \object\counter
使用星號 \ 作為通配符，例如 \object\\counter。

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

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

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

支援部分計數器路徑字串相符專案（例如“pro*”。

在 Windows Vista 之前 ：不支援 部分通配符相符專案。

注意

pdh.h 標頭會根據 UNICODE 預處理器常數的定義，將 PdhExpandWildCardPathH 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 pdh.h
連結庫 Pdh.lib
DLL Pdh.dll

另請參閱

PdhBindInputDataSourceA 函式PdhEnumObjectItemsHA 函式PdhEnumObjectsHA 函式PdhExpandCounterPathA 函式