Método IWDFRemoteTarget::OpenFileByName (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução aoda UMDF .]
O método OpenFileByName abre um de destino de E/S remoto que é um arquivo.
Sintaxe
HRESULT OpenFileByName(
[in] PCWSTR pszFileName,
[in] DWORD DesiredAccess,
[in, optional] PUMDF_IO_TARGET_OPEN_PARAMS pOpenParams
);
Parâmetros
[in] pszFileName
Um ponteiro para um chamador fornecido, cadeia de caracteres nulaterminada que representa o nome do arquivo a ser aberto. Para obter mais informações sobre esse membro, consulte o parâmetro FileName de CreateFile no SDK do Windows.
[in] DesiredAccess
Uma máscara de bits que especifica o acesso desejado do chamador ao arquivo. Para obter mais informações sobre esse membro, consulte o parâmetro dwDesiredAccess de CreateFile no SDK do Windows.
[in, optional] pOpenParams
Um ponteiro para uma estrutura de UMDF_IO_TARGET_OPEN_PARAMS alocada por chamador que contém parâmetros adicionais. Esse parâmetro é opcional e pode ser NULL.
Valor de retorno
OpenFileByName retornará S_OK se a operação for bem-sucedida. Caso contrário, o método poderá retornar o seguinte valor:
| Código de retorno | Descrição |
|---|---|
|
Falha na tentativa da estrutura de alocar memória. |
Esse método pode retornar um dos outros valores que Winerror.h contém.
O verificador de da estrutura relatará um erro se a estrutura não puder abrir o arquivo.
Observações
O driver pode usar OpenFileByName para abrir um arquivo, se a pilha de driver à qual o driver pertence não oferecer suporte ao dispositivo do arquivo. Use IWDFFileHandleTargetFactory::CreateFileHandleTarget para abrir um arquivo, se a pilha de driver à qual o driver pertence oferecer suporte ao dispositivo do arquivo.
O arquivo especificado deve ser acessível pela conta que carregou o driver baseado em UMDF, que normalmente é a conta de Serviço Local. No entanto, se o driver usa representação quando chama OpenFileByName, o arquivo deve estar acessível pela conta representada.
Não chame OpenFileByName para abrir um destino remoto para um objeto de dispositivo de controle. Em vez disso, abra o dispositivo de controle diretamente chamando CreateFile.
Para obter mais informações sobre o método OpenFileByName e destinos de E/S remotos, consulte Destinos gerais de E/S noumdf.
Exemplos
O exemplo de código a seguir cria um objeto de destino remoto e abre um arquivo existente com acesso somente leitura.
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);
Requisitos
| Requisito | Valor |
|---|---|
| fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| da Plataforma de Destino | Área de trabalho |
| versão mínima do UMDF | 1.9 |
| cabeçalho | wudfddi.h (inclua Wudfddi.h) |
| de DLL | WUDFx.dll |