ResUtilSetBinaryValue 함수(resapi.h)

구문

DWORD ResUtilSetBinaryValue(
  [in]                HKEY         hkeyClusterKey,
  [in]                LPCWSTR      pszValueName,
  [in]                const LPBYTE pbNewValue,
  [in]                DWORD        cbNewValueSize,
  [in, out, optional] LPBYTE       *ppbOutValue,
  [in, out]           LPDWORD      pcbOutValueSize
);

매개 변수

[in] hkeyClusterKey

클러스터 데이터베이스에서 이진 값의 위치를 식별하는 키입니다.

[in] pszValueName

업데이트할 값의 이름을 포함하는 null로 종료된 유니코드 문자열입니다.

[in] pbNewValue

새 이진 값에 대한 포인터입니다.

[in] cbNewValueSize

새 이진 값의 크기입니다.

[in, out, optional] ppbOutValue

새 이진 값에 대한 포인터의 주소입니다.

[in, out] pcbOutValueSize

ppbOutValue가 가리키는 값의 크기(바이트)가 반환되는 DWORD에 대한 포인터입니다.

반환 값

작업이 성공하면 함수는 ERROR_SUCCESS 반환합니다.

작업이 실패하면 함수는 시스템 오류 코드를 반환합니다. 다음은 가능한 오류 코드입니다.

반환 코드	설명
ERROR_NOT_ENOUGH_MEMORY	메모리 할당 중에 오류가 발생했습니다.

설명

ResUtilSetBinaryValue 유틸리티 함수는 LocalAlloc 함수를 사용하여 ppbOutValue 포인터에 대한 메모리를 할당하고 Cluster API 함수 ClusterRegSetValue를 호출한 다음 새 값을 이 버퍼에 복사합니다. 포인터가 NULL이 아니면 ResUtilSetBinaryValue 도 할당을 취소합니다. 이 함수의 호출자는 LocalFree 함수를 사용하여 버퍼의 할당을 취소해야 합니다.

다음 리소스 DLL 진입점 함수에서 ResUtilSetBinaryValue 를 호출하지 마세요.

ResUtilSetBinaryValue 는 다른 리소스 DLL 진입점 함수 또는 작업자 스레드에서 안전하게 호출할 수 있습니다. 자세한 내용은 리소스 DLL에서 피해야 할 함수 호출을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
대상 플랫폼	Windows
헤더	resapi.h
라이브러리	ResUtils.lib
DLL	ResUtils.dll