DeleteAtom 함수(winbase.h)

로컬 문자열 원자의 참조 수를 줄입니다. 원자의 참조 횟수가 0으로 줄면 DeleteAtom 은 로컬 원자 테이블에서 원자와 연결된 문자열을 제거합니다.

구문

ATOM DeleteAtom(
  [in] ATOM nAtom
);

[in] nAtom

형식: ATOM

삭제할 원자입니다.

형식: ATOM

함수가 성공할 경우 반환 값은 0입니다.

함수가 실패하면 반환 값은 nAtom 매개 변수입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

문자열 원자의 참조 횟수는 원자가 원자 테이블에 추가된 횟수를 지정합니다. AddAtom 함수는 각 호출의 개수를 증가합니다. DeleteAtom 함수는 각 호출의 개수를 감소하지만 원자의 참조 수가 0인 경우에만 문자열을 제거합니다.

AddAtom에 대한 각 호출에는 DeleteAtom에 대한 해당 호출이 있어야 합니다. AddAtom을 호출하는 것보다 DeleteAtom을 더 많이 호출하지 마세요. 또는 다른 클라이언트가 사용하는 동안 원자를 삭제할 수 있습니다.

DeleteAtom 함수는 정수 원자(값이 0xBFFF 0x0001 범위에 있는 원자)에 영향을 주지 않습니다. 함수는 항상 정수 원자에 대해 0을 반환합니다.

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