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 에 대한 첫 번째 호출에 대해 0이어야 하며 후속 호출에 대해 증가해야 합니다.

하위 키는 정렬되지 않으므로 새 하위 키에는 임의 인덱스가 있습니다. 즉 , ClusterRegEnumKey 는 임의의 순서로 하위 키를 반환할 수 있습니다.

[out] lpszName

null 종료 문자를 포함하여 하위 키의 이름을 수신하는 버퍼에 대한 포인터입니다. 함수는 전체 키 계층 구조가 아닌 하위 키의 이름만 버퍼에 복사합니다.

[in, out] lpcchName

문자 수로 lpszName 버퍼의 크기에 대한 포인터입니다. 입력에서 종료 NULL을 포함하여 버퍼가 보유할 수 있는 최대 문자 수를 지정합니다. 출력에서 종료 되는 NULL을 제외하고 결과 이름의 문자 수를 지정합니다.

[out, optional] lpftLastWriteTime

열거형 하위 키가 마지막으로 수정된 시간을 가리키는 포인터입니다.

반환 값

함수는 다음 값 중 하나를 반환합니다.

설명

ClusterRegEnumKey 함수는 호출할 때마다 하나의 하위 키에 대한 정보를 검색합니다.

ClusterRegEnumKey는 hKey를 NULL로 설정할 때 애플리케이션이 실행되는 노드의 데이터베이스 루트에서 키를 열거하므로 노드가 클러스터에 속하지 않으면 ClusterRegEnumKey가 실패합니다.

요구 사항

추가 정보

클러스터 레지스트리 액세스 함수

ClusterRegOpenKey