Metode IWDFRemoteTarget::OpenFileByName (wudfddi.h)

[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]

Metode OpenFileByName membuka target I/O jarak jauh yang merupakan file.

Sintaks

HRESULT OpenFileByName(
  [in]           PCWSTR                      pszFileName,
  [in]           DWORD                       DesiredAccess,
  [in, optional] PUMDF_IO_TARGET_OPEN_PARAMS pOpenParams
);

Parameter

[in] pszFileName

Penunjuk ke string yang disediakan penelepon dan dihentikan null yang mewakili nama file yang akan dibuka. Untuk informasi selengkapnya tentang anggota ini, lihat parameter FileNamecreateFile di Windows SDK.

[in] DesiredAccess

Bitmask yang menentukan akses pemanggil yang diinginkan ke file. Untuk informasi selengkapnya tentang anggota ini, lihat parameter dwDesiredAccess dari CreateFile di Windows SDK.

[in, optional] pOpenParams

Penunjuk ke struktur UMDF_IO_TARGET_OPEN_PARAMS yang dialokasikan penelepon yang berisi parameter tambahan. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

OpenFileByName mengembalikan S_OK jika operasi berhasil. Jika tidak, metode mungkin mengembalikan nilai berikut:

Menampilkan kode	Deskripsi
E_OUTOFMEMORY	Upaya kerangka kerja untuk mengalokasikan memori gagal.

 

Metode ini mungkin mengembalikan salah satu nilai lain yang dikandung Winerror.h.

Pemverifikasi kerangka kerja melaporkan kesalahan jika kerangka kerja tidak dapat membuka file.

Keterangan

Driver Anda dapat menggunakan OpenFileByName untuk membuka file, jika tumpukan driver tempat driver Anda berada tidak mendukung perangkat file. Gunakan IWDFFileHandleTargetFactory::CreateFileHandleTarget untuk membuka file, jika tumpukan driver tempat driver Anda berada mendukung perangkat file.

File yang ditentukan harus dapat diakses oleh akun yang memuat driver berbasis UMDF, yang biasanya merupakan akun Layanan Lokal. Namun, jika driver menggunakan peniruan ketika memanggil OpenFileByName, file harus dapat diakses oleh akun yang ditiru.

Jangan panggil OpenFileByName untuk membuka target jarak jauh ke objek perangkat kontrol. Sebagai gantinya, buka perangkat kontrol secara langsung dengan memanggil CreateFile.

Untuk informasi selengkapnya tentang metode OpenFileByName dan target I/O jarak jauh, lihat Target I/O Umum di UMDF.

Contoh

Contoh kode berikut membuat objek target jarak jauh dan membuka file yang ada dengan akses baca-saja.

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);
 

Persyaratan

Persyaratan	Nilai
Akhir dukungan	Tidak tersedia di UMDF 2.0 dan yang lebih baru.
Target Platform	Desktop
Versi UMDF minimum	1.9
Header	wudfddi.h (termasuk Wudfddi.h)
DLL	WUDFx.dll

Lihat juga

IWDFDevice2::CreateRemoteTarget

IWDFRemoteTarget

IWDFRemoteTarget::OpenRemoteInterface