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
라이브러리	Mssachlp.lib

추가 정보

ISCPSecureQuery 인터페이스

IWMDMStorageGlobals 인터페이스

WMDMRIGHTS