ISCPSecureQuery3::GetRightsOnClearChannel 메서드(mswmdm.h)

아티클
08/25/2023

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	지정되지 않은 오류가 발생했습니다.