DRMInitEnvironment 関数 (msdrm.h)
[Msdrm.dll のクライアントによって公開される機能を利用する AD RMS SDK は、Windows Server 2008、Windows Vista、Windows Server 2008 R2、Windows 7、Windows Server 2012、Windows 8で使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、Msipc.dll でクライアントによって公開される機能を活用する Active Directory Rights Management Services SDK 2.1 を使用します。
DRMInitEnvironment 関数は、すべての権限管理呼び出しに対してセキュリティで保護された環境を作成します。
構文
DRMEXPORT HRESULT UDAPICALL DRMInitEnvironment(
[in] DRMSECURITYPROVIDERTYPE eSecurityProviderType,
[in] DRMSPECTYPE eSpecification,
[in] PWSTR wszSecurityProvider,
[in] PWSTR wszManifestCredentials,
[in] PWSTR wszMachineCredentials,
[out] DRMENVHANDLE *phEnv,
[out] DRMHANDLE *phDefaultLibrary
);
パラメーター
[in] eSecurityProviderType
使用するセキュリティ プロバイダーの種類を指定します。
[in] eSpecification
使用するセキュリティ プロバイダーを指定します。
[in] wszSecurityProvider
セキュリティ プロバイダーのファイル名と ID。 セキュリティ プロバイダーには、コンピューター上のファイル (ロックボックス) またはセキュリティで保護されたマシン キーを保持するハードウェア デバイスを指定できます。 このキーへのパスは、 DRMGetSecurityProvider を呼び出すことによって取得されます。
[in] wszManifestCredentials
環境の条件を指定する署名付き XrML 構造体。 マニフェストの作成の詳細については、「 アプリケーション マニフェストの作成」を参照してください。
[in] wszMachineCredentials
マシン証明書。
[out] phEnv
環境ハンドルへのポインター。 DRMCloseEnvironmentHandle を呼び出してハンドルを閉じます。
[out] phDefaultLibrary
プリンシパル オブジェクトの作成に使用されるライブラリのハンドルへのポインター。 環境ハンドルを閉じる前に、このハンドルを閉じる必要があります。 詳細については、「解説」を参照してください。 DRMCloseHandle を呼び出して閉じます。
戻り値
関数が成功した場合、関数は S_OKを返します。
関数が失敗した場合は、エラーを示す HRESULT 値を返します。 使用できる値には、次の一覧の値が含まれますが、これらに限定されません。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。
注釈
この関数はロックボックスを読み込み、マニフェストに従って有効な DLL のみが読み込まれることを確認します。
証明書の順序は、最初に最も信頼が低いものから、最も信頼されている (ルートに最も近い) 順です。
この関数によって返されるハンドルを閉じるときは、環境ハンドルを閉じる前にライブラリ ハンドルを閉じます。 それ以外の場合は、 E_DRM_ENV_NOT_LOADED エラーが発生します。 DRMCloseHandle を呼び出してライブラリ ハンドルを閉じます。 DRMCloseEnvironmentHandle を呼び出して、環境ハンドルを閉じます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | msdrm.h |
| Library | Msdrm.lib |
| [DLL] | Msdrm.dll |