IWDFRemoteTarget::OpenFileByName-Methode (wudfddi.h)

Artikel
03/01/2024

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die OpenFileByName-Methode öffnet ein Remote-E/A-Ziel , bei dem es sich um eine Datei handelt.

Syntax

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

Parameter

[in] pszFileName

Ein Zeiger auf eine vom Aufrufer bereitgestellte, mit NULL endende Zeichenfolge, die den Namen der zu öffnenden Datei darstellt. Weitere Informationen zu diesem Member finden Sie im FileName-Parameter von CreateFile im Windows SDK.

[in] DesiredAccess

Eine Bitmaske, die den gewünschten Zugriff des Aufrufers auf die Datei angibt. Weitere Informationen zu diesem Member finden Sie im dwDesiredAccess-Parameter von CreateFile im Windows SDK.

[in, optional] pOpenParams

Ein Zeiger auf eine vom Aufrufer zugewiesene UMDF_IO_TARGET_OPEN_PARAMS Struktur, die zusätzliche Parameter enthält. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

OpenFileByName gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die -Methode möglicherweise den folgenden Wert zurück:

Rückgabecode	Beschreibung
E_OUTOFMEMORY	Fehler beim Versuch des Frameworks, Arbeitsspeicher zuzuweisen.

Diese Methode gibt möglicherweise einen der anderen Werte zurück, die Winerror.h enthält.

Die Überprüfung des Frameworks meldet einen Fehler, wenn das Framework die Datei nicht öffnen kann.

Hinweise

Ihr Treiber kann OpenFileByName verwenden, um eine Datei zu öffnen, wenn der Treiberstapel, zu dem Ihr Treiber gehört, das Gerät der Datei nicht unterstützt. Verwenden Sie IWDFFileHandleTargetFactory::CreateFileHandleTarget , um eine Datei zu öffnen, wenn der Treiberstapel, zu dem Ihr Treiber gehört, das Gerät der Datei unterstützt.

Auf die angegebene Datei muss das Konto zugreifen können, das den UMDF-basierten Treiber geladen hat, wobei es sich in der Regel um das lokale Dienstkonto handelt. Wenn der Treiber beim Aufrufen von OpenFileByName jedoch einen Identitätswechsel verwendet, muss das identitätswechselte Konto auf die Datei zugreifen können.

Rufen Sie OpenFileByName nicht auf, um ein Remoteziel für ein Steuerelementgeräteobjekt zu öffnen. Öffnen Sie stattdessen das Steuerelementgerät direkt, indem Sie CreateFile aufrufen.

Weitere Informationen zur OpenFileByName-Methode und Remote-E/A-Zielen finden Sie unter Allgemeine E/A-Ziele in UMDF.

Beispiele

Im folgenden Codebeispiel wird ein Remotezielobjekt erstellt und eine vorhandene Datei mit schreibgeschütztem Zugriff geöffnet.

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

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.9
Kopfzeile	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Weitere Informationen

IWDFDevice2::CreateRemoteTarget

IWDFRemoteTarget

IWDFRemoteTarget::OpenRemoteInterface