GlobalDeleteAtom 함수(winbase.h)
전역 문자열 원자의 참조 수를 줄입니다. 원자의 참조 수가 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 |
참고 항목
참조