次の方法で共有


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
Library Msdrm.lib
[DLL] Msdrm.dll

関連項目

AD RMS 関数

AD RMS のハンドルとセッション