IWDFRemoteTarget::OpenFileByName 메서드(wudfddi.h)
[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에는 새로운 기능이 추가되지 않으며 최신 버전의 Windows 10에서는 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF시작 .]을 참조하세요.
OpenFileByName 메서드는 파일인 원격 I/O 대상 엽니다.
통사론
HRESULT OpenFileByName(
[in] PCWSTR pszFileName,
[in] DWORD DesiredAccess,
[in, optional] PUMDF_IO_TARGET_OPEN_PARAMS pOpenParams
);
매개 변수
[in] pszFileName
열 파일의 이름을 나타내는 호출자 제공 null종료된 문자열에 대한 포인터입니다. 이 멤버에 대한 자세한 내용은 Windows SDK에서 CreateFileFileName 매개 변수를 참조하세요.
[in] DesiredAccess
파일에 대한 호출자의 원하는 액세스를 지정하는 비트 마스크입니다. 이 멤버에 대한 자세한 내용은 Windows SDK에서 CreateFiledwDesiredAccess 매개 변수를 참조하세요.
[in, optional] pOpenParams
추가 매개 변수를 포함하는 호출자 할당 UMDF_IO_TARGET_OPEN_PARAMS 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL 수 있습니다.
반환 값
OpenFileByName 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 메서드가 다음 값을 반환할 수 있습니다.
| 반환 코드 | 묘사 |
|---|---|
|
프레임워크의 메모리 할당 시도가 실패했습니다. |
이 메서드는 Winerror.h에 포함된 다른 값 중 하나를 반환할 수 있습니다.
프레임워크의 검증 도구는 프레임워크가 파일을 열 수 없는 경우 오류를 보고할 있습니다.
발언
드라이버가 속한 드라이버 스택이 파일의 디바이스를 지원하지 않는 경우 OpenFileByName 사용하여 파일을 열 수 있습니다. 드라이버가 속한 드라이버 스택이 파일의 디바이스를 지원하는 경우 IWDFFileHandleTargetFactory::CreateFileHandleTarget 사용하여 파일을 엽니다.
일반적으로 로컬 서비스 계정인 UMDF 기반 드라이버를 로드한 계정으로 지정된 파일에 액세스할 수 있어야 합니다. 그러나 드라이버가 OpenFileByName호출할 때 가장 사용하는 경우 가장된 계정으로 파일에 액세스할 수 있어야 합니다.
OpenFileByName 호출하여 제어 디바이스 개체에 대한 원격 대상을 열지 마세요. 대신 CreateFile호출하여 제어 디바이스를 직접 엽니다.
OpenFileByName 메서드 및 원격 I/O 대상에 대한 자세한 내용은 UMDF 일반 I/O 대상을 참조하세요.
예제
다음 코드 예제에서는 원격 대상 개체를 만들고 읽기 전용 액세스 권한이 있는 기존 파일을 엽니다.
UMDF_IO_TARGET_OPEN_PARAMS openParams;
HRESULT hr;
//
// Create a new remote target object and provide a callback
// object to handle remote target events.
//
CComPtr<IWDFRemoteTarget> fxTarget;
hr = FxDevice->CreateRemoteTarget(MyRemoteTargetIUnknown,
fxRemoteInterface,
&fxTarget);
if (FAILED(hr)) goto Error;
//
// Open existing file for read-only access.
//
openParams.dwShareMode = 0;
openParams.dwCreationDisposition = OPEN_EXISTING;
openParams.dwFlagsAndAttributes = FILE_ATTRIBUTE_READONLY;
hr = fxTarget->OpenFileByName(FILE_PATH,
GENERIC_READ,
&openParams);
요구 사항
| 요구 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 최소 UMDF 버전 | 1.9 |
| 헤더 | wudfddi.h(Wudfddi.h 포함) |
| DLL | WUDFx.dll |