IUnknown::AddRef 메서드(unknwn.h)

  • 아티클

COM 개체에 대한 인터페이스 포인터에 대한 참조 수를 증분합니다. 인터페이스 포인터의 복사본을 만들 때마다 이 메서드를 호출해야 합니다.

구문

ULONG AddRef();

반환 값

메서드는 새 참조 수를 반환합니다. 이 값은 테스트 목적으로만 사용됩니다.

설명

COM 개체는 인터페이스별 참조 계산 메커니즘을 사용하여 개체가 참조보다 오래 지속되지 않도록 합니다. AddRef를 사용하여 인터페이스 포인터의 복사본을 안정화합니다. 복제된 포인터의 수명이 원래 포인터의 수명을 초과해야 하는 경우에도 호출할 수 있습니다. 복제된 포인터는 IUnknown::Release 를 호출하여 해제해야 합니다.

AddRef에서 유지 관리하는 내부 참조 카운터는 부호 없는 32비트 정수여야 합니다.

발신자에 대한 참고 사항

만드는 인터페이스 포인터의 모든 새 복사본에 대해 이 메서드를 호출합니다. 예를 들어 메서드에서 포인터의 복사본을 반환하는 경우 해당 포인터에서 AddRef 를 호출해야 합니다. 또한 메서드에 인아웃 매개 변수로 전달하기 전에 포인터에서 AddRef 를 호출해야 합니다. 메서드는 위에 있는 out-value를 복사하기 전에 IUnknown::Release 를 호출합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 unknwn.h

추가 정보