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 中 CreateFile 的 dwDesiredAccess 參數。
[in, optional] pOpenParams
呼叫端配置的 UMDF_IO_TARGET_OPEN_PARAMS 結構的指標，其中包含其他參數。 這個參數是選擇性的，而且可以 NULL。
傳回值
如果作業成功，OpenFileByName 會傳回S_OK。 否則，方法可能會傳回下列值：
| 傳回碼 | 描述 |
|---|---|
|
架構嘗試配置記憶體失敗。 |
這個方法可能會傳回 Winerror.h 所包含的其他其中一個值。
如果架構無法開啟檔案，架構的 驗證器 報告錯誤。
言論
如果驅動程式所屬的驅動程式堆疊不支援檔案的裝置，您的驅動程式可以使用 OpenFileByName 來開啟檔案。 如果使用 IWDFFileHandleTargetFactory：：CreateFileHandleTarget 開啟檔案，如果驅動程式所屬的驅動程式堆疊支援檔案的裝置，請使用 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 |