Função CheckNameLegalDOS8Dot3W (winbase.h)

Artigo
11/20/2024

Determina se o nome especificado pode ser usado para criar um arquivo em um sistema de arquivos FAT.

Sintaxe

BOOL CheckNameLegalDOS8Dot3W(
  [in]            LPCWSTR lpName,
  [out, optional] LPSTR   lpOemName,
  [in]            DWORD   OemNameSize,
  [out, optional] PBOOL   pbNameContainsSpaces,
  [out]           PBOOL   pbNameLegal
);

Parâmetros

[in] lpName

O nome do arquivo, no formato 8.3.

[out, optional] lpOemName

Um ponteiro para um buffer que recebe a cadeia de caracteres OEM que corresponde a Name. Esse parâmetro pode ser NULL.

[in] OemNameSize

O tamanho do buffer lpOemName , em caracteres. Se lpOemName for NULL, esse parâmetro deverá ser 0 (zero).

[out, optional] pbNameContainsSpaces

Indica se um nome contém ou não espaços. Esse parâmetro pode ser NULL. Se o nome não for um nome válido do sistema de arquivos FAT 8.3, esse parâmetro será indefinido.

[out] pbNameLegal

Se a função for bem-sucedida, esse parâmetro indicará se um nome de arquivo é um nome de arquivo FAT 8.3 válido quando a página de código OEM atual é aplicada ao nome do arquivo.

Valor de retorno

Se a função for bem-sucedida, o valor retornado não será zero.

Se a função falhar, o valor retornado será 0 (zero). Para obter informações de erro estendidas, chame GetLastError.

Observações

Essa função pode ser usada para determinar se um nome de arquivo pode ou não ser passado para um aplicativo baseado no Windows de 16 bits ou um aplicativo baseado em MS-DOS.

No Windows 8 e no Windows Server 2012, essa função é compatível com as tecnologias a seguir.

Tecnologia	Suportado
Protocolo SMB (Bloco de Mensagens do Servidor) 3.0	Sim
TFO (Failover Transparente) do SMB 3.0	Ver comentários
SMB 3.0 com Compartilhamentos de Arquivos de Expansão (SO)	Ver comentários
Sistema de Arquivos de Volume Compartilhado de Cluster (CsvFS)	Sim
ReFS (Sistema de Arquivos Resiliente)	Sim

Observe que o SMB 3.0 não dá suporte a nomes curtos em compartilhamentos com funcionalidade de disponibilidade contínua, portanto, a função sempre retornará zero (falha).

Nota

O cabeçalho winbase.h define CheckNameLegalDOS8Dot3 como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista, Windows XP com SP1 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winbase.h (inclua Windows.h)
biblioteca	Kernel32.lib
de DLL	Kernel32.dll

Consulte também

Funções de gerenciamento de arquivos

GetOEMCP

Compartilhar via