Função ClfsMgmtRegisterManagedClient (wdm.h)

  • Artigo

A rotina ClfsMgmtRegisterManagedClient cria um cliente que gerenciará um log CLFS.

Sintaxe

CLFSUSER_API NTSTATUS ClfsMgmtRegisterManagedClient(
  [in] PLOG_FILE_OBJECT               LogFile,
  [in] PCLFS_MGMT_CLIENT_REGISTRATION RegistrationData,
       PCLFS_MGMT_CLIENT              ClientCookie
);

Parâmetros

[in] LogFile

Um ponteiro para uma estrutura LOG_FILE_OBJECT que representa o fluxo de log CLFS que o cliente criado por ClfsMgmtRegisterManagedClient gerenciará.

[in] RegistrationData

Uma instância da estrutura CLFS_MGMT_CLIENT_REGISTRATION que contém as funções que serão usadas para gerenciar o log.

ClientCookie

O cookie que devolvemos ao chamador para uso futuro da API.

Retornar valor

A rotina ClfsMgmtRegisterManagedClient retorna um dos seguintes valores NTSTATUS:

Código de retorno Descrição
STATUS_SUCCESS
 Um cliente foi criado para gerenciar o log.
STATUS_UNSUCCESSFUL
 O gerenciamento do CLFS não pôde criar um cliente para gerenciar o log.
STATUS_INSUFFICIENT_RESOURCES
 Não há memória suficiente para concluir a operação.
STATUS_INVALID_PARAMETER
 Um parâmetro de entrada é inválido.
 

Essa rotina também pode retornar outros valores NTSTATUS.

Comentários

O parâmetro Client fornecido pela rotina ClfsMgmtRegisterManagedClient é um parâmetro necessário para outras funções de gerenciamento CLFS. Você deve armazenar esse valor para uso posterior.

Um aplicativo cliente deve estar pronto para que sua rotina de retorno de chamada seja chamada assim que chamar a rotina ClfsMgmtRegisterManagedClient .

Mais de um cliente pode se registrar com um fluxo de log.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Server 2003 R2, Windows Vista e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Confira também

CLFS_MGMT_CLIENT_REGISTRATION

LOG_FILE_OBJECT