ISensorManager::RequestPermissions 메서드(sensorsapi.h)

센서 데이터에 액세스할 수 있는 사용자 권한을 요청하는 시스템 대화 상자를 엽니다.

Syntax

HRESULT RequestPermissions(
  [in] HWND              hParent,
  [in] ISensorCollection *pSensors,
  [in] BOOL              fModal
);

매개 변수

[in] hParent

Windows 8의 경우 hParent 에 값이 제공되면 대화 상자가 부모 창으로 모달이 됩니다. hParent가 NULL이면 대화 상자가 모달이 되지 않습니다. 대화 상자는 항상 동기적입니다.

Windows 7의 경우 HWND 는 사용 권한 대화 상자의 부모 역할을 할 수 있는 창에 대한 핸들입니다. fModal이 TRUE이면 NULL이어야 합니다.

[in] pSensors

Windows 8의 경우 이 값은 사용되지 않습니다.

Windows 7의 경우 pSensors 는 사용 권한이 요청되는 센서 목록을 포함하는 ISensorCollection 인터페이스에 대한 포인터입니다.

[in] fModal

Windows 8의 경우 이 값은 사용되지 않습니다. 형식을 제어하려면 hParent 를 참조하세요.

Windows 7의 경우 fModal 은 대화 상자 모드를 지정하는 BOOL 입니다. hParent가 null이 아닌 경우 FALSE여야 합니다.

반환 값

다음 표에서는 동기 결과에 대한 반환 코드에 대해 설명합니다.

다음 표에서는 비동기 결과에 대한 반환 코드를 설명합니다.

비고

Windows 애플리케이션의 UI(사용자 인터페이스) 스레드에서 동기 호출을 하면 UI 스레드를 차단하고 애플리케이션의 응답성이 떨어집니다. 이를 방지하려면 fModal 이 TRUE로 설정된 UI 스레드에서 이 메서드를 호출하지 마세요.

예시

다음 예제 코드는 비동기 메서드 호출을 사용하여 유형별로 센서 관리자에서 검색된 모든 센서에 대한 권한을 요청합니다. 플랫폼은 사용자에게 아직 사용하도록 설정되지 않은 센서를 사용하도록 설정하라는 메시지만 표시합니다. 이 경우 사용자가 센서를 사용하도록 설정했는지 여부를 확인하려면 ISensorEvents::OnStateChanged 이벤트를 처리해야 합니다. 사용 권한을 요청하는 방법을 보여 주는 추가 예제는 사용자 권한 요청을 참조하세요.

// Get the sensor collection.
hr = pSensorManager->GetSensorsByType(SAMPLE_SENSOR_TYPE_TIME, &pSensorColl);

if(SUCCEEDED(hr))
{
    // Request permissions for all sensors
    // in the collection.
    hr = pSensorManager->RequestPermissions(0, pSensorColl, FALSE);
}

요구 사항

참고하십시오

ISensorManager

사용자 권한 관리

사용자 권한 요청