Rotinas de gerenciamento de blocos de conexão e controle de arquivos

As rotinas de gerenciamento de blocos de conexão e controle de arquivos são usadas pelo RDBSS para gerenciar estruturas usadas para representar conexões e blocos de controle de arquivos.

O RDBSS fornece as seguintes rotinas para o gerenciamento de blocos de conexão e controle de arquivos que podem ser usados por drivers de minidiretório de rede:

Rotina	Descrição
RxCreateNetFcb	Essa rotina aloca, inicializa e insere uma nova estrutura FCB nas estruturas de dados na memória para uma estrutura NET_ROOT na qual esta FCB está sendo aberta. A estrutura alocada tem espaço para um SRV_OPEN e uma estrutura FOBX. Essa rotina é usada internamente pelo RDBSS e não deve ser usada por minidiretórios de rede.
RxCreateNetFobx	Essa rotina aloca, inicializa e insere uma nova estrutura de FOBX (extensão de objeto de arquivo). Os minidiretórios de rede devem chamar essa rotina para criar um FOBX no final de uma operação de criação bem-sucedida.
RxCreateNetRoot	Essa rotina cria um nó que representa uma estrutura NET_ROOT e insere o nome na tabela net name no objeto de dispositivo associado. Essa rotina é usada internamente pelo RDBSS e não deve ser usada por minidiretórios de rede.
RxCreateSrvCall	Essa rotina cria um nó que representa um contexto de chamada de servidor e insere o nome na tabela de nomes de rede mantida pelo RDBSS. Essa rotina é usada internamente pelo RDBSS e não deve ser usada por minidiretórios de rede.
RxCreateSrvOpen	Essa rotina aloca, inicializa e insere uma nova estrutura SRV_OPEN nas estruturas de dados na memória usadas pelo RDBSS. Se uma nova estrutura precisar ser alocada, ela terá espaço para uma estrutura FOBX. Essa rotina é usada internamente pelo RDBSS e não deve ser usada por minidiretórios de rede.
RxCreateVNetRoot	Essa rotina cria um nó que representa uma estrutura V_NET_ROOT e insere o nome na tabela net name. Essa rotina é usada internamente pelo RDBSS e não deve ser usada por minidiretórios de rede.
RxDereference	Essa rotina diminui a contagem de referência em uma instância de várias das estruturas de dados contadas por referência usadas pelo RDBSS.
RxFinalizeConnection	Essa rotina exclui uma conexão com um compartilhamento. Todos os arquivos abertos na conexão são fechados dependendo do nível de força especificado. O minidiretório de rede pode optar por manter a conexão de transporte aberta por motivos de desempenho, a menos que alguma opção seja especificada para forçar o fechamento da conexão.
RxFinalizeNetFcb	Essa rotina finaliza a estrutura fcb fornecida. O chamador deve ter um bloqueio exclusivo na estrutura de NET_ROOT associada a esse FCB. Essa rotina é usada internamente pelo RDBSS e não deve ser usada por minidiretórios de rede.
RxFinalizeNetFobx	Essa rotina finaliza a estrutura do FOBX fornecida. O chamador deve ter um bloqueio exclusivo no FCB associado a esse FOBX. Essa rotina é usada internamente pelo RDBSS e não deve ser usada por minidiretórios de rede.
RxFinalizeNetRoot	Essa rotina finaliza a estrutura de NET_ROOT fornecida. O chamador deve ter bloqueio exclusivo na tabela NetName do objeto de dispositivo associado a essa estrutura NET_ROOT (por meio da estrutura SRV_CALL). Essa rotina é usada internamente pelo RDBSS e não deve ser usada por minidiretórios de rede.
RxFinalizeSrvCall	Essa rotina finaliza a estrutura de SRV_CALL fornecida. O chamador deve ter acesso exclusivo ao bloqueio na tabela NetName do objeto do dispositivo associado a essa estrutura SRV_CALL. Essa rotina é usada internamente pelo RDBSS e não deve ser usada por minidiretórios de rede.
RxFinalizeSrvOpen	Essa rotina finaliza a estrutura de SRV_OPEN fornecida. Essa rotina é usada internamente pelo RDBSS e não deve ser usada por minidiretórios de rede.
RxFinalizeVNetRoot	Essa rotina finaliza a estrutura de V_NET_ROOT fornecida. O chamador deve ter acesso exclusivo ao bloqueio na tabela NetName do objeto de dispositivo associado a essa estrutura V_NET_ROOT. Essa rotina é usada internamente pelo RDBSS e não deve ser usada por minidiretórios de rede.
RxFinishFcbInitialization	Essa rotina é usada para concluir a inicialização de um FCB após a conclusão bem-sucedida de uma operação de criação pelo minidiretório de rede.
RxForceFinalizeAllVNetRoots	Essa força de rotina finaliza todas as estruturas de V_NET_ROOT associadas a uma determinada estrutura de NET_ROOT. O chamador deve ter acesso exclusivo ao bloqueio na tabela NetName do objeto de dispositivo associado a essa estrutura V_NET_ROOT. Essa rotina é usada internamente pelo RDBSS e não deve ser usada por minidiretórios de rede.
RxGetFileSizeWithLock	Essa rotina obtém o tamanho do arquivo no cabeçalho FCB, usando um bloqueio para garantir que o valor de 64 bits seja lido de forma consistente.
RxInferFileType	Essa rotina tenta inferir o tipo de arquivo (diretório ou não diretório) de um campo na estrutura RX_CONTEXT.
RxLockEnumerator	Essa rotina é chamada de um minidiretório de rede para enumerar os bloqueios de arquivo em um FCB.
RxpDereferenceAndFinalizeNetFcb	Essa rotina diminui a contagem de referências e finaliza um FCB. Essa rotina só está disponível no Windows Server 2003 Service Pack 1 (SP1) e posterior.
RxpDereferenceNetFcb	Essa rotina diminui a contagem de referência em um FCB.
RxpReferenceNetFcb	Essa rotina incrementa a contagem de referência em um FCB.
RxReference	Essa rotina incrementa a contagem de referência em uma instância de várias das estruturas de dados contadas por referência usadas pelo RDBSS.
RxSetSrvCallDomainName	Essa rotina define o nome de domínio associado a qualquer servidor determinado (estrutura SRV_CALL).

Observe que várias macros também são definidas que fornecem wrappers em torno das rotinas RxReference e RxDeference para depuração. Para obter mais informações sobre essas macros, consulte Diagnóstico e Depuração.