次の方法で共有

ISCPSecureQuery::GetRights メソッド (mswmdm.h)

  • [アーティクル]

GetRights メソッドは、現在のコンテンツの権限情報を取得します。 権限はファイル固有です。

構文

HRESULT GetRights(
  [in]      BYTE                *pData,
  [in]      DWORD               dwSize,
  [in]      BYTE                *pbSPSessionKey,
  [in]      DWORD               dwSessionKeyLen,
  [in]      IMDSPStorageGlobals *pStgGlobals,
  [out]     PWMDMRIGHTS         *ppRights,
  [out]     UINT                *pnRightsCount,
  [in, out] BYTE [8]            abMac
);

パラメーター

[in] pData

GetDataDemands によって要求されたデータへのポインター。 このパラメーターは、入力メッセージ認証コードに含まれている必要があり、暗号化する必要があります。

[in] dwSize

pData バッファー内のデータのバイト数。 このパラメーターは、入力メッセージ認証コードに含まれている必要があります。

[in] pbSPSessionKey

pStgGlobals が指すサービス プロバイダーとの通信をセキュリティで保護するためのセッション キーを含むバイト配列へのポインター。 このパラメーターは、入力メッセージ認証コードに含まれている必要があり、暗号化する必要があります。

[in] dwSessionKeyLen

pbSPSessionKey が指すバイト配列の長さ。 このパラメーターは、入力メッセージ認証コードに含まれている必要があります。

[in] pStgGlobals

ファイルの転送元または転送元のメディアまたはデバイスのルート ストレージ上の IWMDMStorageGlobals インターフェイスへのポインター。

[out] ppRights

このオブジェクトの権限情報を含む WMDMRIGHTS 構造体の配列へのポインター。 配列はこのメソッドによって割り当てられ、 CoTaskMemFree を使用して解放する必要があります。 このパラメーターは、出力メッセージ認証コードに含まれています。

[out] pnRightsCount

ppRights 配列内の WMDMRIGHTS 構造体の数。 このパラメーターは、出力メッセージ認証コードに含まれています。

[in, out] abMac

このメソッドのパラメーター データのメッセージ認証コードを含む 8 バイトの配列。 (WMDM_MAC_LENGTHは 8 と定義されます。

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合は、 HRESULT エラー コードが返されます。

リターン コード 説明
WMDM_E_CALL_OUT_OF_SEQUENCE
 このメソッドは順序外で呼び出されました。 GetDataDemands と ExamineData は、最初にこの順序で呼び出す必要があります。
WMDM_E_MAC_CHECK_FAILED
 メッセージ認証コードが無効です。
WMDM_E_NORIGHTS
 呼び出し元には、要求された操作を実行するために必要な権限がありません。
E_INVALIDARG
 パラメーターが無効であるか、 NULL ポインターです。
E_FAIL
 未指定のエラーが発生しました。

解説

このメソッドは 、GetDataDemands が呼び出されてから 、その順序で ExamineData が呼び出されるまで呼び出してはなりません。

要件

要件 値
対象プラットフォーム Windows
ヘッダー mswmdm.h
Library Mssachlp.lib

こちらもご覧ください

ISCPSecureQuery インターフェイス

IWMDMStorageGlobals インターフェイス

WMDMRIGHTS