InitAtomTable 함수(winbase.h)

아티클
03/06/2024

로컬 원자 테이블을 초기화하고 해시 버킷 수를 지정된 크기로 설정합니다.

구문

BOOL InitAtomTable(
  [in] DWORD nSize
);

매개 변수

[in] nSize

형식:DWORD

원자 테이블에 사용할 해시 버킷의 수입니다. 이 매개 변수가 0이면 기본 해시 버킷 수가 만들어집니다.

성능을 향상시키려면 nSize에서 소수를 지정합니다.

반환 값

형식: BOOL

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다.

설명

애플리케이션은 로컬 원자 테이블을 사용하기 위해 이 함수를 사용할 필요가 없습니다. 사용되는 해시 버킷의 기본 수는 37개입니다. 그러나 애플리케이션 에서 InitAtomTable을 사용하는 경우 다른 atom-management 함수 앞에 함수를 호출해야 합니다.

애플리케이션에서 많은 수의 로컬 원자를 사용하는 경우 원자를 로컬 원자 테이블에 추가하거나 테이블 크기를 늘려 테이블에서 원자를 찾는 데 필요한 시간을 줄일 수 있습니다. 그러나 이렇게 하면 테이블을 유지하는 데 필요한 메모리 양이 증가합니다.

전역 원자 테이블의 버킷 수는 변경할 수 없습니다. InitAtomTable에 대한 이전 호출을 통해 명시적으로 또는 atom 관리 함수를 사용하여 암시적으로 원자 테이블을 이미 초기화한 경우 InitAtomTable은 해시 버킷 수를 변경하지 않고 성공을 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winbase.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll