다음을 통해 공유


DRMCloseHandle 함수(msdrm.h)

[에 의해 노출되는 기능을 활용하는 AD RMS SDK

Msdrm.dll 클라이언트는 Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012 및 Windows 8에서 사용할 수 있습니다. 또는 변경될 수 있습니다.

사용할 수 없습니다. 대신 Active Directory Rights Management Services SDK 2.1을 사용합니다.

Msipc.dll 클라이언트에서 노출하는 기능을 활용합니다.]

DRMCloseHandle 함수는 DRMLoadLibrary를 사용하여 로드된 DRMCreate* 함수 및 라이브러리로 만든 개체에 대한 핸들을 닫습니다.

구문

DRMEXPORT HRESULT UDAPICALL DRMCloseHandle(
  [in] DRMHANDLE handle
);

매개 변수

[in] handle

닫을 핸들입니다.

반환 값

함수가 성공하면 함수는 S_OK 반환합니다.

함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 일반적인 오류 코드 목록은 일반 HRESULT 값을 참조하세요.

설명

이 함수는 메모리에서 중요한 데이터를 올바르게 지우고 AD RMS 시스템에서 사용되는 개체에 대한 정확한 참조 수를 유지할 수 있도록 합니다. 개체에 열려 있는 다른 개체가 포함된 경우 이 함수를 호출하면 포함된 모든 개체도 강제로 닫힙니다. 그러나 이러한 방식으로 포함된 개체를 강제로 닫는 것은 권장되지 않습니다.

이 함수가 실패하면 애플리케이션은 DRMCloseEnvironmentHandle을 사용하여 환경을 닫은 후 현재 프로세스를 삭제해야 합니다.

라이브러리에 대한 핸들을 닫으면 열려 있는 개체가 남아 있지 않으면 라이브러리가 언로드됩니다.

요구 사항

   
대상 플랫폼 Windows
헤더 msdrm.h
라이브러리 Msdrm.lib
DLL Msdrm.dll

참고 항목

AD RMS 함수

AD RMS 핸들 및 세션