Função CreateLogFile (clfsw32.h)
Cria ou abre um log. O log pode ser dedicado ou multiplexado e isso depende do nome do log. Use a função CloseHandle para fechar o log.
Sintaxe
CLFSUSER_API HANDLE CreateLogFile(
[in] LPCWSTR pszLogFileName,
[in] ACCESS_MASK fDesiredAccess,
[in] DWORD dwShareMode,
[in, optional] LPSECURITY_ATTRIBUTES psaLogFile,
[in] ULONG fCreateDisposition,
[in] ULONG fFlagsAndAttributes
);
Parâmetros
[in] pszLogFileName
O nome do log.
Esse nome é especificado ao criar o log usando CreateLogFile. O exemplo a seguir identifica o formato a ser usado.
Log:<LogName>[::<LogStreamName>]
Por exemplo: o caminho "LOG:c:\MyDirectory\MyLog" cria o arquivo "c:\MyDirectory\MyLog.blf". O caminho "?? \LOG:\HarddiskVolume1\MyDirectory\MyLog" cria o arquivo "\.\HarddiskVolume1\MyDirectory\MyLog.blf", assim como o caminho "\clfs\Device\HarddiskVolume1\MyDirectory\MyLog".
<Logname> corresponde a um caminho de arquivo válido no sistema de arquivos, e <LogStreamName> é o nome exclusivo de um fluxo de log no log. Para obter mais informações, consulte Tipos de log.
[in] fDesiredAccess
O tipo de acesso que o identificador retornado tem ao objeto de log.
Valor | Significado |
---|---|
|
Especifica o acesso de leitura ao objeto . |
|
Especifica o acesso de gravação ao objeto . |
|
Especificar o acesso à exclusão de log |
Um OR bit a bit de dois ou mais desses sinalizadores permite combinações de acesso de leitura, gravação e exclusão ao objeto.
[in] dwShareMode
O modo de compartilhamento de um arquivo.
Um cliente não pode solicitar um modo de compartilhamento que entre em conflito com qualquer modo especificado em qualquer solicitação aberta anterior que tenha um identificador aberto.
Se esse parâmetro for zero e a função for bem-sucedida, o objeto não poderá ser compartilhado e não poderá ser aberto novamente até que o identificador seja fechado.
Esse parâmetro pode usar um dos valores a seguir.
[in, optional] psaLogFile
Um ponteiro para uma estrutura SECURITY_ATTRIBUTES que especifica os atributos de segurança de um log.
Ele determina se o identificador retornado pode ser herdado por processos filho. Se esse parâmetro for NULL, o identificador não poderá ser herdado.
O membro lpSecurityDescriptor do SECURITY_ATTRIBUTES especifica um descritor de segurança para o novo identificador de log. Se psaLogFile for NULL, o objeto obterá um descritor de segurança padrão. As ACL (listas de controle de acesso) no descritor de segurança padrão para um log vêm do token primário ou de representação do criador.
[in] fCreateDisposition
Uma ação a ser tomada.
Esse parâmetro pode usar um dos valores a seguir.
[in] fFlagsAndAttributes
Os atributos e sinalizadores de arquivo para o arquivo.
Esse parâmetro pode obter os valores a seguir.
Retornar valor
Se a função for bem-sucedida, o valor retornado será um identificador para o log.
Se houver falha na função, o valor retornado será INVALID_HANDLE_VALUE. Para obter informações de erro estendidas, chame GetLastError.
A lista a seguir identifica os possíveis códigos de erro:
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2003 R2 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | clfsw32.h |
Biblioteca | Clfsw32.lib |
DLL | Clfsw32.dll |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de