Função FilterGetDosName (fltuser.h)

Artigo
02/29/2024

A função FilterGetDosName retorna o nome do dispositivo MS-DOS que corresponde ao nome do volume fornecido.

Sintaxe

HRESULT FilterGetDosName(
  [in]  LPCWSTR lpVolumeName,
  [out] LPWSTR  lpDosName,
  [in]  DWORD   dwDosNameBufferSize
);

Parâmetros

[in] lpVolumeName

Ponteiro para uma cadeia de caracteres largos terminada em NULL que contém o nome do volume.

A cadeia de caracteres de entrada lpVolumeName pode ser qualquer uma das opções a seguir. A barra invertida à direita (\) é opcional.

Uma letra de unidade, como "D:\"
Um caminho para um ponto de montagem de volume, como "c:\mnt\edrive\"
Um identificador de volume exclusivo (também chamado de nome GUID de volume), como "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
Um nome de dispositivo não persistente (também chamado de nome de destino ou nome de dispositivo NT), como "\Device\HarddiskVolume1\"

Esse parâmetro é necessário e não pode ser NULL.

[out] lpDosName

Ponteiro para um buffer alocado pelo chamador que recebe o nome do dispositivo MS-DOS como uma cadeia de caracteres largos terminada em NULL.

[in] dwDosNameBufferSize

Tamanho, em caracteres largos, do buffer para o qual lpDosName aponta.

Retornar valor

FilterGetDosName retornará S_OK se tiver êxito. Caso contrário, retornará um valor de erro.

Comentários

FilterGetDosName retornará a letra da unidade do volume se tiver uma. Se nenhuma letra da unidade for atribuída ao volume, FilterGetDosName retornará um caminho para um ponto de montagem de volume (também chamado de nome de ponto de montagem). Se nenhuma letra de unidade ou pontos de montagem forem definidos para o volume, FilterGetDosName retornará S_OK e lpDosName receberá NULL.