다음을 통해 공유


InitAtomTable 함수(winbase.h)

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

구문

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

참고 항목

AddAtom

DeleteAtom

FindAtom

GetAtomName

GlobalAddAtom

GlobalDeleteAtom

GlobalFindAtom

GlobalGetAtomName

참조