ClusterRegEnumKey 函式 (clusapi.h)
列舉開放式 叢集資料庫 密鑰的子機碼。
語法
LONG ClusterRegEnumKey(
[in] HKEY hKey,
[in] DWORD dwIndex,
[out] LPWSTR lpszName,
[in, out] LPDWORD lpcchName,
[out, optional] PFILETIME lpftLastWriteTime
);
參數
[in] hKey
指定目前開啟金鑰的 HKEY。
[in] dwIndex
用來識別要列舉之下一個子機碼的索引。 第一次呼叫 ClusterRegEnumKey 時，此參數應該是零，然後針對後續呼叫遞增。
因為子機碼未排序，所以任何新的子機碼都有任意索引。 這表示 ClusterRegEnumKey 可以依任何順序傳回子機碼。
[out] lpszName
接收子機碼名稱的緩衝區指標，包括 null 終止字元。 函式只會將子機碼的名稱，而不是完整金鑰階層複製到緩衝區。
[in, out] lpcchName
lpszName 緩衝區大小做為字元計數的指標。 在輸入上，指定緩衝區可以保留的最大字元數，包括終止 的NULL。 在輸出上，指定結果名稱中的字元數，不包括終止 的NULL。
[out, optional] lpftLastWriteTime
上次修改列舉子機碼時的指標。
傳回值
函式會傳回下列其中一個值。
| 傳回碼/值 | Description |
|---|---|
|
作業成功。 |
|
不會再傳回子機碼。 |
|
lpszName 所指向的緩衝區不夠大，無法保存結果。 lpcchName 參數會傳回結果中的字元數，不包括終止 NULL。 |
| 作業失敗。 |
備註
ClusterRegEnumKey 函式會在每次呼叫時擷取一個子機碼的相關信息。
因為 ClusterRegEnumKey 會從應用程式設定為 NULL 時執行之節點上資料庫的根目錄列舉索引鍵，所以如果節點不是叢集的一部分，ClusterRegEnumKey 就會失敗。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 目標平台 | Windows |
| 標頭 | clusapi.h |
| 程式庫 | ClusAPI.lib |
| Dll | ClusAPI.dll |