ClusterRegBatchAddCommand 함수(clusapi.h)

클러스터 레지스트리 키에서 실행되는 일괄 처리에 명령을 추가합니다. 함수에 대한 추가 호출은 일괄 처리에 추가된 추가 명령을 생성합니다. 일괄 처리는 ClusterRegCreateBatch 함수에 의해 만들어졌으며 ClusterRegCloseBatch 함수에서 실행되거나 무시됩니다.

구문

LONG ClusterRegBatchAddCommand(
  [in]           HREGBATCH           hRegBatch,
  [in]           CLUSTER_REG_COMMAND dwCommand,
  [in, optional] LPCWSTR             wzName,
  [in]           DWORD               dwOptions,
  [in, optional] VOID const          *lpData,
  [in]           DWORD               cbData
);

매개 변수

[in] hRegBatch

명령을 추가할 일괄 처리의 핸들입니다.

[in] dwCommand

CLUSTER_REG_COMMAND 열거형에서 가져온 이 API에서 지원하는 명령입니다. 가능한 명령은 다음과 같습니다.

CLUSREG_SET_VALUE (1)

마지막으로 실행된 CLUSREG_CREATE_KEY 명령 또는 ClusterRegCreateBatch 함수에 전달된 키를 기준으로 값을 설정합니다(제공되지 않은 경우).

CLUSREG_CREATE_KEY (2)

지정한 클러스터 레지스트리 키가 없는 경우 만들거나 기존 레지스트리 키를 엽니다.

CLUSREG_DELETE_KEY (3)

모든 값과 중첩된 하위 키가 있는 키를 삭제합니다. 값에 대해 작동하는 명령은 CLUSREG_CREATE_KEY 추가될 때까지 CLUSREG_DELETE_KEY 따를 수 없습니다.

CLUSREG_DELETE_VALUE (4)

마지막으로 실행된 CLUSREG_CREATE_KEY 명령 또는 ClusterRegCreateBatch 함수에 전달된 키를 기준으로 값을 삭제합니다(제공되지 않은 경우).

[in, optional] wzName

dwCommand 매개 변수에서 발급한 명령을 기준으로 하는 값 또는 키의 이름입니다.

[in] dwOptions

dwCommand가 CLUSREG_SET_VALUE 명령을 사용하는 경우 이 매개 변수는 표준 레지스트리 값 형식 중 하나를 사용합니다. 그렇지 않으면 dwCommand 가 0으로 설정됩니다.

[in, optional] lpData

dwCommand에서 발급한 명령을 기준으로 하는 데이터에 대한 포인터입니다. 이 매개 변수의 값은 CLUSREG_SET_VALUE 명령을 제외한 모든 매개 변수에 대해 NULL입니다.

[in] cbData

dwCommand에서 발급한 명령에 상대적인 데이터의 수(바이트)입니다. 이 매개 변수의 값은 CLUSREG_SET_VALUE 명령을 제외한 모든 매개 변수에 대해 0입니다.

반환 값

함수는 다음 시스템 오류 코드 중 하나를 반환합니다.

설명

PCLUSTER_REG_BATCH_ADD_COMMAND 형식은 이 함수에 대한 포인터를 정의합니다.

요구 사항

추가 정보

CLUSTER_REG_COMMAND

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

ClusterRegCloseBatch

ClusterRegCreateBatch

레지스트리 값 형식