GlobalDeleteAtom 함수(winbase.h)

아티클
03/06/2024

전역 문자열 원자의 참조 수를 줄입니다. 원자의 참조 수가 0에 도달하면 GlobalDeleteAtom 은 원자와 연결된 문자열을 전역 원자 테이블에서 제거합니다.

구문

ATOM GlobalDeleteAtom(
  [in] ATOM nAtom
);

매개 변수

[in] nAtom

형식: ATOM

삭제할 원자 및 문자 문자열입니다.

반환 값

형식: ATOM

함수는 항상 (ATOM) 0을 반환합니다.

함수가 실패했는지 여부를 확인하려면 GlobalDeleteAtom을 호출하기 전에 ERROR_SUCCESSSetLastError를 호출한 다음 GetLastError를 호출합니다. 마지막 오류 코드가 여전히 ERROR_SUCCESS 경우 GlobalDeleteAtom 이 성공했습니다.

설명

문자열 원자의 참조 수는 문자열이 원자 테이블에 추가된 횟수를 지정합니다. GlobalAddAtom 함수는 호출할 때마다 전역 원자 테이블에 이미 존재하는 문자열의 참조 수를 증분합니다.

GlobalAddAtom에 대한 각 호출에는 GlobalDeleteAtom에 대한 해당 호출이 있어야 합니다. GlobalAddAtom을 호출하는 것보다 GlobalDeleteAtom을 더 많이 호출하지 마세요. 또는 다른 클라이언트가 사용하는 동안 원자를 삭제할 수 있습니다. DDE(동적 데이터 교환)를 사용하는 애플리케이션은 누출 및 조기 삭제를 방지하기 위해 전역 원자 관리에 대한 규칙을 따라야 합니다.

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

예제

예제는 대화 시작을 참조하세요.

요구 사항

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