CeSetFileAttributes (RAPI)
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função define os atributos de um arquivo em um remoto dispositivo baseado em Windows Embedded CE.
Syntax
BOOL CeSetFileAttributes(
LPCWSTR lpFileName,
DWORD dwFileAttributes
);
Parameters
lpFileName
[no] Ponteiro longo para um seqüência de caracteres NULL-Terminated que especifica o nome do arquivo cujos atributos devem ser definidas.Há um limite tamanho seqüência de caracteres usar como padrão para caminhos de caracteres MAX_PATH.
dwFileAttributes
[no] Especifica os atributos arquivo definido para o arquivo. Este parâmetro pode ser uma combinação dos seguinte valores. No entanto, todos os outros substituir valores FILE_ATTRIBUTE_NORMAL.Valor Descrição FILE_ATTRIBUTE_ARCHIVE
O arquivo é um arquivo. Os aplicativos usam esse atributo para arquivos marca para de backup ou remoção.
FILE_ATTRIBUTE_HIDDEN
O arquivo está oculto. Ele não está incluído em um listagem de diretórios comum.
FILE_ATTRIBUTE_NORMAL
O arquivo não tem nenhum outros um conjunto de atributos. Esse atributo é válido somente se usado sozinho.
FILE_ATTRIBUTE_READONLY
O arquivo é somente leitura. Os aplicativos podem ler o arquivo, mas não é possível gravar nele ou excluí-la.
FILE_ATTRIBUTE_SYSTEM
O arquivo é parte de sistema operacional ou é usado exclusivamente por ele.
FILE_ATTRIBUTE_TEMPORARY
O arquivo está sendo usado para armazenamento temporário. Arquivo sistemas tentar manter todos os dados na memória para acessar rather than liberando os dados mais rápido voltar para armazenamento em massa. Um arquivo temporário deve ser excluído pelo aplicativo assim ele não for mais necessária.
Return Value
Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar CeGetLastError e CeRapiGetError.
Remarks
O CeSetFileAttributes função não trabalho sobre o ROM sistema de arquivos. Inerentemente, este chamar é dependente sobre o suporte fornecido por um driver sistema de arquivos sistema de arquivos.
Não é um aplicativo alteração os atributos de um Diretório no sistema de arquivos de memória RAM.
A seguinte tabela descreve como definir os atributos em sistema de arquivos de memória RAM que não pode ser definida usando CeSetFileAttributes.
| Atributo | Como definir |
|---|---|
FILE_ATTRIBUTE_COMPRESSED |
Para definir estado compactação de um arquivo, use o DeviceIoControl função com a operação FSCTL_SET_COMPRESSION. |
FILE_ATTRIBUTE_DIRECTORY |
Arquivos não podem ser convertidos em diretórios. Para criar um Diretório, use o CeCreateDirectory função. |
FILE_ATTRIBUTE_REPARSE_POINT |
Para associar um apontar reanalisar com um arquivo, use o DeviceIoControl função com a operação FSCTL_SET_REPARSE_POINT. |
FILE_ATTRIBUTE_SPARSE_FILE |
Para definir atributo esparso de um arquivo, use o DeviceIoControl função com a operação FSCTL_SET_SPARSE. |
Nem todos os sistemas arquivo suporte todos os atributos.
Requirements
| Header | rapi.h |
| Library | rapi.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Pocket PC 2002 and later, Smartphone 2002 and later |