ISCPSecureQuery3::GetRightsOnClearChannel メソッド (mswmdm.h)

[アーティクル]
02/29/2024

GetRightsOnClearChannel メソッドは、クリアチャネル上の現在のコンテンツの権限情報を取得します。

構文

HRESULT GetRightsOnClearChannel(
  [in]  BYTE                *pData,
  [in]  DWORD               dwSize,
  [in]  BYTE                *pbSPSessionKey,
  [in]  DWORD               dwSessionKeyLen,
  [in]  IMDSPStorageGlobals *pStgGlobals,
  [in]  IWMDMProgress3      *pProgressCallback,
  [out] PWMDMRIGHTS         *ppRights,
  [out] UINT                *pnRightsCount
);

パラメーター

[in] pData

データオブジェクトへのポインター。

[in] dwSize

pData バッファー内のデータのバイト数。

[in] pbSPSessionKey

pStgGlobals が指すサービスプロバイダーとの通信をセキュリティで保護するためのセッションキーを含むバイト配列へのポインター。

[in] dwSessionKeyLen

pbSPSessionKey が指すバイト配列の長さ。

[in] pStgGlobals

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

[in] pProgressCallback

IWMDMProgress3 インターフェイスへのポインター。

[out] ppRights

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

[out] pnRightsCount

ppRights 配列内の WMDMRIGHTS 構造体の数。

戻り値

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

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