Função SetupWriteTextLogInfLine (setupapi.h)
A função SetupWriteTextLogInfLine grava uma entrada de log em um log de texto SetupAPI que contém o texto de uma linha de arquivo INF especificada.
Sintaxe
WINSETUPAPI VOID SetupWriteTextLogInfLine(
[in] SP_LOG_TOKEN LogToken,
[in] DWORD Flags,
[in] HINF InfHandle,
[in] PINFCONTEXT Context
);
Parâmetros
[in] LogToken
Um token de log que é um token de log definido pelo sistema ou que foi retornado por SetupGetThreadLogToken.
[in] Flags
Um valor do tipo DWORD que é um OR bit a bit de valores de sinalizador, que especificam o seguinte:
- O nível de evento para a entrada de log. Os níveis de evento que podem ser especificados para uma entrada de log são os mesmos que podem ser habilitados para um log de texto. Para obter uma lista de sinalizadores de nível de evento, consulte Definindo o nível de evento para um log de texto setupAPI.
- Se deve incluir um carimbo de data/hora na entrada de log. O valor do sinalizador de carimbo de data/hora é TXTLOG_TIMESTAMP.
- A alteração, se houver, para a profundidade de recuo da seção e a entrada de log atual. Para obter informações sobre como usar os sinalizadores de recuo, consulte Gravando entradas de log recuadas.
[in] InfHandle
Um identificador para o arquivo INF que inclui a linha de texto a ser gravada no log de texto. Um identificador para um arquivo INF é obtido chamando SetupOpenInfFile, que está documentado no SDK da Plataforma.
[in] Context
Um ponteiro para um contexto de arquivo INF que especifica a linha de texto a ser gravada no log de texto. Um contexto de arquivo INF para uma linha é obtido chamando as funções SetupFindXxxLine . Para obter informações sobre arquivos INF e um contexto de arquivo INF, consulte as informações fornecidas no SDK da Plataforma sobre como usar arquivos INF, obtendo um contexto de arquivo INF e a estrutura INFCONTEXT.
Retornar valor
Nenhum
Comentários
SetupWriteTextLogInfLine grava uma entrada de log no seguinte formato:
entry-prefixtime-stampinf:indentationinf-line-text(inf-file-nameline-number)
Em que:
- Os campos de prefixo de entrada e carimbo de data/hora são os mesmos descritos em Formato de um Corpo da Seção de Log de Texto.
- O campo inf-line-text contém o texto da linha de arquivo INF especificada.
- O campo inf-file-name contém o nome do arquivo INF que contém a linha de arquivo INF especificada.
- O campo número de linha contém o número de linha da linha especificada no arquivo INF.
Para obter informações gerais sobre como gravar entradas de log nos logs de texto SetupAPI, consulte SetupAPI Logging (Windows Vista).
Para obter mais informações sobre a operação de SetupWriteTextLogInfLine, consulte Chamando SetupWriteTextLogInfLine.
Para obter mais informações sobre os vários tipos de tokens de log, consulte Tokens de log.
Para obter mais informações sobre como usar tokens de log, consulte Configurando e obtendo um token de log para um thread.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Vista e versões posteriores do Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | setupapi.h (inclua Setupapi.h) |
| Biblioteca | Setupapi.lib |
| DLL | Setupapi.dll |